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System Control and System Service Programs 

(16K Tape) 

This publication describes the 16K tape 
resident version of the IBM Basic Operating 
Systein/360. The system is a set of control 
programs and processing programs provided 
for smaller configurations of the IBM 
System/360. Using IBM 2400-series magnetic 
tape units for on-line program residence, 
Basic Operating System/360 provides 
stacked- job processing capability, controls 
all input/output, and provides for continu- 
ous operation of all programs run in its 
environment. Detailed information is given 
in this publication on these major topics. 

1. Operation with the System control Pro- 
gram: 

a. System Organization 

b. Supervisor Functions 

c. Job Control Program. 

2. Using the System Service Programs: 

a. Linkage Editor 

b. Librarian. 

The prerequisite for a thorough under- 
standing of this publication is a basic 
knowledge of System/360 machine concepts. 
The publications most closely related to 
this one are: 




1. 



3. 



4. 



IBM System/360 Principles of Operation , 
Form A22-6821. 

I BM Basic Operating System/360; Data 
Management Concepts (16K Tape) , Form 
C24-3U30^^«^,- : 

IBM Basic Operating System/360; Super- 
visor and Input/Output Macros (16K 
Tape) , Form C24-3U32. 



IBM Basic Operating 
System/360; Assembler Language 



{16K 








Disk/Tape) , Form C24-3414, 





PREFACE 



The first part of this publication, under 
the headings Supervisor , Job Control , and 
IPL Loader , describes the control program 
for Basic Operating System/360. This part 
is of interest to anyone using the system, 
including system analysts, programmers, and 
machine operators. The functions of the 
Supervisor are discussed, and the detailed 
Job Control statement formats are given. 
Note, however, that the macro instructions 
used to communicate with the Supervisor are 
discussed fully in the Supervisor and I/O 
Marcos publications as listed on the front 
cover of this publication. 

The second part of this publication, 
under the headings Linkage Editor and 
Librarian , is of particular interest to the 
persons responsible for generating and 
maintaining the resident system. This part 
describes the Linkage Editor and Librarian 
programs fully, and gives a general des- 
cription for generating systems. 



Copie-s of this and other ibm publications can be obtained through ihm Branch Offices. 

A form has been provided at the back of this pubhcation for readers' comments. If the form has been 

detached, comments may be directed to ibm Programming Publications, Endicott, New York 13764. 
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INTRODUCTION 



The 16K tape resident version of the IBM 
Basic Operating System/360 is designed to 
provide operating system capabilities for 
16K and larger System/360 configurations 
that include four or more IBM 2400-series 
magnetic tape units. Systems above 16K 
that do not require the expanded functions 
provided in the larger operating system 
packages offered by IBM will benefit from 
this 16K package. The system is tape resi- 
dent, using IBM 2400-series magnetic tape 
units for on-line storage of all programs. 
Depending on the requirements of the parti- 
cular application, the system can be 
expanded to include all procassing programs 
used to perform the various jobs of a par- 
ticular installation, or it can be tailored 
to a minimum system to control a single 
program. 

The 16K system consists of the following 
components . 



The control program supervises all 
input/output functions. Required control 
program input/output units are: 

1. System Residence (SYSRES): system 
residence unit 

2. System Reader (SYSRDR) ; unit used for 
Job Control statements 

3. System Input (SYSIPT): system input 
unit 

U. System Punch (SYSPCH) : system output 
unit 

5. System List (SYSLST): system printer 
unit 

6. System Communication (SYSLOG) : medium 
for operator communication. 



Control Program 



The control program constitutes the frame- 
work of the Basic Operating System/360. It 
prepares and controls the execution of all 
other programs. The components of the 
control program are: 

1. Supervisor . The Supervisor handles all 
input/output operations, interruption 
conditions, and other functions for all 
problem programs. Part of the Supervi- 
sor resides in main storage at all 
times. Processing time is divided 
between the Supervisor and the program 
being executed. This is true for the 
user's programs as well as other IBM- 
supplied components of the system. 
Certain functions of the Supervisor are 
provided by transient routines that 
remain on tape until needed and which 
are then loaded into main storage; for 
execution. 

2. Job Control . Job Control runs between 
parts of a job and prepares the system 
for execution of all other programs. 
Job Control is loaded by the Supervisor 
from tape whenever needed. 

3. IPL Loader . The IPL Loader loads the 
Supervisor into main storage when sys- 
tem operation is initiated. The IPL 
Loader is loaded from tape simply by 
selecting the address of the tape unit 
in the load-unit switches on the system 
console and pressing the load key. 



System Service Programs 



The system service programs provide the 
functions of generating the system, creat- 
ing and maintaining the library sections, 
and editing programs on tape before execu- 
tion. Minimum Systems can be built that do 
not include the system service programs. 
Such minimum systems still require tape 
residence. 

The system service programs are: 

1. Linkage Editor . All programs are edit- 
ed on a specified tape by this program. 
These programs can then be permanently 
placed in the core image library of the 
system, requiring only control state- 
ments to call them for execution, or 
they can be stored on tape temporarily, 
executed, and then overlayed by new 
programs. 

2. Librarian . This is actually a group of 
programs , used for maintaining the tape 
libraries and providing printed and 
punched output from the libraries. 
Three libraries are used. 

a. Core image library . All permanent 
programs in the system 
(IBM-supplied and user programs) 
are loaded from this library by the 
System Loader routine of the 
Supervisor. 

b. Source statement library . This 
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library is used to store IBM- 
supplied macro definitions and 
user-defined source statement 
routines (such as macro 
definitions) on the tape built to 
provide extended program- asserably 
capability. 

Relocatable library . This library 
is used to store object modules 
which can be used for subsequent 
linkage with other program modules. 
A module also can be a complete 
program. 



One Card Punch (1442, 2520, or 25U0) . 
See Note 2 . 

One Printer (1U03, 1U04, or 1443). See 
Note 2. 

One 1052 Printer-Keyboard. 

One 2400-series magnetic tape drive 

(9-track) for system residence and three 
2400-series magnetic tape drives for 
language translator functions. An addi- 
tional tape drive is required for 
compile- and- execute functions. Except 
for system residence, 7 -track tape units 
can be used, but the data-convert feature 
is required. 



Processing Programs 



Note 1 ; Language translators may require 
extended instruction sets. 



All user programs are run within the Basic 
Operating Systerri/360 environment, using the 
functions of the control program. Minimum 
resident systems may consist of only the 
control program and one or more user pro- 
grams or, for other types of applications, 
the; control program and the Linkage Editor, 
with user programs loaded and edited from 
cards or tape on a specified tape, and then 
into main storage for execution. A full 
system may include the user's programs and 
th€i following IBM-supplied programs: 

1. Language Translators: Assembler, COBOL, 
FORTRAN, RPG, and PL/ I. 

2. Sort/Merge. 

3. Utilities. 

4. Autotest. 



Note 2 ; One 24 00-series magnetic tape 
drive may be substituted for this device. 
(7- or 9-track. If 7-track drives are 
used, the data- convert feature is required, 
except when substituted for a printer. ) 



Additional features supported: 



Timer Feature. 

Simultaneous Read-while-Write Tape 

Control (2404 or 2804). 
Any channel configuration up to one 

multiplexor channel and six selector 

channels . 
Tape Switching Unit (2816). 
Storage Protection Feature. 
Additional main storage up to 1024K 

bytes. 



SYSTEM CONFIGURATION 



This section presents the minimum system 
configuration required to operate the Basic 
Operating System/360 and the features in 
addition to the minimum that can be sup- 
ported. The system control programs must 
always be present in order to execute any 
other programs . 



MACHINE REQUIREMENTS 



Minimum features required: 

16K bytes of main storage. 

Standard instruction set. See Note 1 . 

One I/O Channel (either multiplexor or 

S€ilector) . 
One Card Reader (1442, 2501, 2520, or 

2540) . See Note 2. 



Problem programs can request I/O operations 
on the following devices: 

1. 14 42 Card Read Punch 

2. 2501 Card Reader 
2520 Card Read Punch 
2 540 Card Read Punch 
1403 Printer 



3. 

4. 
5. 
6. 

7. 
8. 
9. 



1404 Printer (for continuous forms 
only) 

1443 Printer 

1445 Printer 

1052 Printer-Keyboard (Only one 1052 
is supported. It is used for operator 
communication. ) 



10. 2401, 2402, 2403, 2404, and 2415 Mag- 
netic Tape Units. 



CONTROL STATEMENT CONVENTIONS 



The conventions used in this publication to 
illustrate control statements are as fol- 
lows. 

1. Uppercase letters and punctuation marks 
(except as described in items 3 through 
5 below) represent information that 
must be coded exactly as shown. 

2. Lowercase letters and terms represent 
information that must be supplied by 
the programmer. 



3. Information contained within brackets 
[ ] represents an option that can be 
. included or omitted, depending on the 
requirements of the program. 



4. Options contained within braces { } 
represent alternatives, one of which 
must be chosen. 



5, An ellipsis (a series of three periods) 
indicates that a variable number of 
items may be included. 
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SUPERVISOR 



The Supervisor is the control program that 
operates with problem programs. Part of 
the Supervisor eilways resides in main stor- 
age. Certain other routines that are used 
infrequently are kept in the core image 
library on the resident tape unit and are 
called into the transient area when needed. 
The functions performed by the Supervisor 
are: 

1. Storage protection (optional) 

2. Interruption handling 

3. Channel scheduling 

4. Device error recovery 

5 . Operator communication 

6. Program retrieval 

7. End-of- job handling 

8 . Checkpoint 

9. Label processing 

10. Timer services (optional). 

All functions except certain interrup- 
tion handling (SVC, I/O, and machine check) 
are available to the problem program by 
issuing macro instructions. The programmer 
is not concerned with machine interruption 
conditions, since these are handled auto- 
matically by the Supervisor. 

The Supervisor also contains a communi- 
cation region for holding information use- 
ful to problem programs and to the Supervi- 
sor itself. 

The Supervisor is generated from a set 
of source statements by way of an Assesmbler 
run. 



I/O UNITS CONTROL TABLES 



The principal components of the I/O Units 
Control Tables are the Logical Unit Blocks 
(LUB) and Physical Unit Blocks (PUB). 
These tables, defined when the system is 
generated, are required for channel sche- 
duling, input/output unit assignment and 
control, and maintenance of miscellaneous 
information about jobs, such as multiple 
I/O assignments. 



Each LUB is two bytes and represents one 
logical (symbolic) I/O unit. Each LUB 
references an entry in the PUB. LUB's 
corresponding to logical units are ordered 
according to the logical units they rep- 
resent. Information concerning the order- 
ing of LUB's is contained in the subsection 
under Job Control entitled Logical Unit 
Block (LUB) and Physical Unit Block (PUB) . 
The LUB's are grouped into two classes: 
system logical units and programmer logical 
units. The number of programmer logical 
units is a system generation parameter with 
a maximum of 2U5. 



Each PUB is eight bytes and represents 
one physical I/O unit. Contained in each 
PUB is such information as the channel and 
unit numbers of the device, the character- 
istics of the device, references to the 
channel queue, and indicators used by the 
Channel Scheduler, Supervisor, and Job 
Control. The PUB's are ordered by the 
number of the channel to which the various 
devices are attached. The number of PUB's 
is a system generation parameter with a 
maximum of 2 55. 



COMMUNICATION REGION 



MAIN STORAGE ORGANIZATION 



Th€j Supervisor occupies the lower area of 
main storage. The transient routines are 
called into the transient area (overlaying 
the previous routine in the area) and exe- 
cuted when needed. The area occupied by 
the problem program begins just past the 
transient area. The main storage map in 
Figure 1 shows the relationship between the 
Supervisor and the problem programs. 



The communication region is a 4U-byte stor- 
age area within the Supervisor region for 
use by the Supervisor and problem programs. 
Certain macro instructions are available to 
allow access to the information contained 
in this region. Fields in the communi- 
cation region are addressed relative to the 
first byte of the region. 



The layout of the communication region 
in the Supervisor is shown in Figure 2 and 
is described below. 
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Figure 1. Main Storage organization 



8 bytes Calendar date. Supplied 

during IPL procedure or by 
DATE control statement. Can 
be used by logical IOCS for 
dating printed output of the 
problem program. In one of 
two forms: mm/dd/yy or 
dd/mm/yy where mm is month, 
dd is day, and yy is year. 

2 bytes Address of problem program 
label area. 

2 bytes Length of problem program 
label area. 

11 bytes User area (for inter- or 
intra-program 
communications). Last 3 
bytes set to zero when EXEC 
control statement is encoun- 
tered. All 11 bytes set to 
zero when JOB control state- 
ment is encountered. 

1 byte UPSI (user program switch 

indicators). Set to binary 
zero when a JOB statement is 
encountered. 

8 bytes JOB name as found in the JOB 
control statement. 

4 bytes Address of the uppermost 

byte of the problem- prog ram 
area. 

4 bytes Address of the uppermost 
byte of a phase placed in 
the problem- prog ram area by 
the last FETCH or LOAD. 
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Figure 2. Communication Region in Supervisor 
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^ bytes Address of the uppermost 
byte used in loading any 
phase of the problem pro- 
gram. 



program area. A key of is set for the 
Supervisor and transient areas. 



communication Region Macro Instructions 



Macro instructions are provided to allow 
the problem program to access the communi- 
cation region. A brief discussion of these 
macro instructions follows. Details will 
be found in the Supervisor and I/O Macros 
publication. 

COMRG — Get address of communication 

region: 

This macro instruction allows the prob- 
lem program to address information 
stored in the communication region 
(obtain date, test switches, etc). The 
address of the first byte of the region 
is placed in general register 1. 

MVCOM — Move to communication region: This 
macro instruction allows the problem 
program to modify the content of the 
user area and UPSI (bytes 12 through 
23) of the communication region. The 
operand field of the MVCOM macro 
instruction contains three operands. 
The first specifies the first communi- 
cation region byte to be modified.. The 
second specifies the number of bytes to 
be inserted. The last specifies the 
address (or a register containing the 
address) of the bytes to be inserted. 



SUPERVISOR FUNCTIONS 



STORAGE PROTECTION 



The Supervisor has the responsibility of 
setting storage protection keys. A storage 
protection key of 1 is set for the problem 



INTERRUPTION HANDLING 



An interruption is an automatic transfer of 
control from any storage location to a 
predetermined storage location. It can be 
caused by either a program instruction or a 
machine condition. The Supervisor automat- 
ically handles all interruptions so that 
the programmer need not be directly con- 
cerned with them. In most cases after an 
interruption is handled, control is 
returned to the point of interruption as if 
no break had occurred in the instruction 
sequence. 

There are five kinds of interruptions. 
They are: 

1. Supervisor call 

2. External 

3. Program check 

U. Machine check 

5. Input/output. 

Figure 3 illustrates the flow of control 
between the Supervisor and a problem pro- 
gram during an interruption, control is in 
the problem program initially. An inter- 
ruption occurs, transferring control to the 
Supervisor. The status of the program is 
saved in the Program Old PSW. Depending on 
the type and reason for the interruption, 
control is given to an appropriate handling 
routine. Upon completion of the routine, 
the program may be restored to its original 
condition (via the old PSW) . Control is 
normally given back to the problem program 
at the point where it was interrupted. The 
user may have control of program check and 
external interruptions . 
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Interruption 



SUPERVISOR 



PROBLEM 
PROGRAM 




(Problem Program State) 



PROGRAM 



Machine Check 



Wait State 
Entered 



(Supervisor State) 



Figure 3. Flow of control Between Supervisor and Problem Program During an Interruption 



Supervisor Call 



The supervisor call interruption is caused 
when the SVC instruction is executed. Cer- 
tain macros use the SVC (supervisor call) 
instruction to provide communication 
between the problem program and the Super- 
visor. The SVC in each macro has a certain 
interruption code that indicates to the 
Supervisor which routine is to be executed. 

The macro instructions that allow prob- 
lem programs to have access to Supervisor 
functions via an SVC instruction are: 

CANCEL To cancel all remaining steps of 
a job. 

CHKPT To cause checkpoints to be taken 
in a problem program. 

CLOSE To close an input/output file. 

DUMP To get a printout of main storage 
and terminate the problem pro- 
gram. 

EOJ To call Job Control to prepare 
the next job step to be run. 

EXCP (Execute channel program) To 

request an I/O operation to be 
performed by physical IOCS. 

EXIT To return to the user's main 



program after the user's handling 
of an external or program check 
interruption. 

FETCH To load into main storage from 
the core image library (or 
SYSOOO) a program for execution. 

LBRET To return from the problem pro- 
gram to an OPEN, CLOSE, or end- 
of- of-volume routine 

LOAD To load into main storage from 
the core image library (or 
SYSOOO) a phase that is not to be 
executed immediately. 

MVCOM To modify the content of the user 
area in the communication region. 

OPEN To open an input/output file for 
processing. 

SETIME To request the Supervisor to 
interrupt the execution of a 
program after a specified period 
of time has elapsed. 

STXIT To establish a linkage from the 
Supervisor to a user routine 
(program check or external 
interruption) or to cancel the 
use of such a routine. 

Each macro instruction generates a 
supervisor call interruption with a speci- 
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fie parameter. The interruption routine 
analyzes the parameter and gives control to 
another routine for the actual handling of 
the interruption. 



Time- stamps the beginning and end of a 
job. This information can be used for 
accounting information and can be 
printed on the devices assigned to 
SYSLOG and SYSLST. 



External Interruption 



An external interruption can be caused by 
the timer feature, or by the operator 
prcissing the console interrupt key, or by 
an external signal. 

If an interrupt-key or external-signal 
interruption occurs, control is immediately 
given back to the interrupted program 
unless the user has provided an address of 
his own routine through an STXIT macro 
instruction. Wlien this is the case, con- 
trol is transferred to the address speci- 
fied. 

The timer feeiture enables the control 
program to provide three functions: 

1. Maintains the time of day which the 

user can reference at any point within 
the execution of the problem program. 



3. Enables the user to set the timer for a 
specific internal of time and to get 
control at a prespecified address after 
the time interval has elapsed. 

If the presence of the timer feature was 
not specified when the system was generat- 
ed, all timer interruptions are ignored and 
cause control to be returned immediately to 
the interrupted program. 

Four macro instructions are provided for 
use with external interruptions. These 
macro instructions are GETIME, SETIME, 
STXIT, and EXIT. Figure 4 illustrates a 
typical sequence of events following an 
external interruption. 

GETIME — Get time of day: 

This macro instruction can be used at 
any point in the execution of a problem 
program to get the time of day. The 
value returned to the problem program 
can be in one of three forms , depending 
upon the requirements of the user. The 



Problem Program 



Main Line 
STXIT 

Interval Timer 
, , Causes on InterrupMon 



-1 — *■ 



Execution Continues 



Supervisor 



to Supervisor Routine- 




User 's 

Interval Timer 
Routine 



(Problem Program State) 




Timer Interruption 
Handling Routines 



(Supervisor State) 



Figure 4. Typical Sequence of Events After a Timer Interruption Due to Use of SETIME 
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time can be in hours, minutes, and sec- 
onds, or it can be a binary integer (in 
seconds) , or it can be in units of 1/300 
seconds. This macro instruction can be 
used only if the timer feature is 
installed and if its presence is indi- 
cated when the system is generated. 

SETIME — Set interval timer: 

This macro instruction can be used to 
request the Supervisor to interrupt the 
execution of a problem program after a 
specified time limit has elapsed. This 
macro instruction can be used only if 
the timer feature is installed and if 
its presence is indicated when the sys- 
tem is generated. 

STXIT — Set linkage to user interruption 

routine: 

This macro instruction can be used to 
establish a linkage from the Super\fisor 
to a user routine. It can also be used 
to cancel the linkage to such a routine. 
This macro instruction can be used for 
external interruptions and program-check 
interruptions . 

EXIT — Set exit: 

This macro instruction is used with the 
STXIT macro instruction to return from 
the user's routine to the point of 
interruption. 

A complete description of these macro 
instructions is supplied in the Supervisor 
and I/O Macros publication. 



Program Check 



Each program can select which of the fol- 
lowing options is to be taken in the event 
of a program check. 

1. Abort — The job being executed is 
terminated and a message output on 
SYSLOG and SYSLST describes the cause 
of the termination. 

2. Dump and Abort — This is requested by 
use of the DUMP option in the OPTION 
control statement. In addition to a 
message, all registers and main storage 
are printed on SYSLST. The job step is 
then terminated, 

3. Transfer to User Routine — If the 
address of a subroutine is supplied by 
the user by way of the STXIT macro 
instruction, the program-check inter- 
ruption routine will branch to that 
subroutine when an appropriate inter- 
ruption occurs. The user routine can 
determine the cause of the interrup- 
tion. Return to the point of interrup- 



tion is possible by means of the EXIT 
macro instruction. 



Machine Check 



A machine- check interruption results from a 
machine malfunction. The machine- check 
interruption places the system in the wait 
state with an identifying code in the main 
storage address register on the console. 
The system can be restarted only through an 
IPL procedure. 

A machine-check interruption is simulat- 
ed by the I/O device, error routines by 
loading the machine check PSW if a detected 
error condition requires exceptional han- 
dling by an IBM Customer Engineer. Opera- 
tion can be continued if the affected 
device is not required. 



Input/Output Interruptions 



An input/output interruption can be caused 
by: 

1. I/O completion — (Channel End). This 
is the end of transfer of data into or 
out of main storage or completion of a 
control operation. 

2. I/O attention — This results from 
pressing the request key of the 1052. 

3. Device available — (Device End). A 
device which was busy or not ready is 
now available for use. 

4. Control unit available — (Control Unit 
End) . A control unit which was busy is 
now available for use. 

When one of these conditions is detect- 
ed, control transfers to the Channel 
Scheduler. (Note that except for posting a 
program- control led interruption (PCI) to 
the user CCB, a program-controlled inter- 
ruption, occurring as the result of the PCI 
flag in a CCW, is ignored by the Channel 
Scheduler. ) 



CHANNEL SCHEDULER 



Complete control of data input/output is 
accomplished through two kinds of routines: 
physical and logical . Supervisor 
input/output control consists of only phy- 
sical routines (the actual transfer of data 
between main storage and some I/O device) . 
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Theise routines make up the Channel Schedul- 
er . The functions it perforins are: 

1. Schedule I/O requests on each channel 
(queuing) . 

2. Start input/output operations. 

3. Handle I/O interruptions — normal com- 
pletion of data transfer, error detec- 
tion, end-of-file detection, attention 
(1052). 

4. Perform error detection and correction. 

5. Detect end-of-job and end-of- job- step 
control statements on SYSRDR and 
SYSIPT. 

All I/O devices in the System/360 are 
attached to channels rather than attached 
directly to the CPU. A channel provides a 
path for data transfer between the CPU and 
th€; I/O device and allows I/O operations to 
be overlapped with CPU processing and I/O 
opesrations on other channels. That is, 
instructions can be executed simultaneously 
with data movement in one or more 
input/output channels. For instance, at a 
given point in time, one channel may be 
reading data from a tape, another channel 
may be writing data on a printer, and a 
previously read record may be being proc- 
essed. This is referred to as 
read/write/compute overlap. 

Two types of channels are provided in 
this system: selector channels and the 
multiplexor channel. The selector channels 
allow I/O operations for devices on these 
channels to be overlapped with CPU process- 
ing and I/O operations on other channels. 
Card, printer, and other low-speed (byte 
interleave mode} I/O devices can be over- 
lapped with each other, with CPU process- 
ing, and with I/O operations on other chan- 
nels. Thus, greater throughput can be 
achieved if high-speed devices (tape) are 
attached to selector channels, and low- 
speed devices (card and printer) are 
attached to the multiplexor channel. 

Overlapping I/O operations with CPU 
processing is inherent in the design of the 
machine and the Channel Scheduler. Howev- 
er, achieving mciximum overlapping also 
partially depends on the problem program. 
For instance, if overlap is desired in tape 
operations, the problem program should 
provide for two I/O areas (or buffers) . 
This allows data to be read into, or writ- 
ten from, one I/O area while records are 
being processed in the other area. Certain 
devices, however, have buffers built into 
the device (14 03) and require only one I/O 
area in main storage to achieve overlap. 
The use of multiple I/O areas and separate 
work areas is discussed more fully in the 



Data Management publication, as listed on 
the front cover of this publication. 

All requests for I/O operations are 
handled by the Channel Scheduler. When a 
request is received and the affected chan- 
nel and device are not busy, the requested 
operation starts and control passes back to 
the problem program. If the channel or 
device is busy, the request is placed at 
the end of a list (or queue ) of I/O 
requests and the operation is performed as 
soon as all previous requests have been 
handled. (Separate queues are maintained 
for each device. ) 

The Channel Scheduler also handles all 
I/O interruptions. If the interruption 
indicates the normal end of an I/O opera- 
tion (channel end and no errors), the chan- 
nel Scheduler posts completion and removes 
the request from the queue. It then exam- 
ines the queues for the affected channel. 
If the queues are empty, control is 
returned to the problem program at the 
point of interruption. If instead a 
request is pending, the Channel Scheduler 
starts the I/O operation and then returns 
to the problem program. Requests for devi- 
ces for which device-end interruptions are 
outstanding cannot be serviced until the 
device end is reached. These requests will 
be bypassed when the Channel Scheduler is 
selecting an I/O operation to be started. 
For example, for a 1U03, channel end is 
received as soon as the buffer has been 
completely loaded (about 4ms) , but device 
end is not received until completion of the 
print operation (100ms). 

The Channel Scheduler detects the fol- 
lowing specific status conditions: 

1. Wrong Length Record (WLR) 

2. End of File (EOF) 

3. End of tape 

U. Channel and device errors. 

Upon detection of the WLR condition, the 
Channel Scheduler sets an indicator on and 
supplies the residual count to the problem 
program. At this point, after posting 
channel end, the Channel Scheduler resche- 
dules the channel. 

Upon detection of an EOF condition, the 
Channel Scheduler sets an indicator on for 
the problem program and, as above, resche- 
dules the channel. 

If an error is detected, all interrup- 
tions remain disabled and the Channel 
Scheduler passes control to the appropriate 
device error recovery routine, which takes 
appropriate action — retry, operator 
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intervention, notify problem program, or 
terminate job. 

For certain devices (1052) , an I/O oper- 
ation can be initiated by the operator. To 
do this, the operator presses the request 
key on the device. When the Channel 
Scheduler detects an attention status con- 
dition, it passes control to the Supervisor 
1052 routine. 



instructions. The block is used to 
pass information between the problem 
program and the Channel Scheduler, such 
as status of the operation, action to 
be taken in the event of an error, etc. 

A complete description of these macro 
instructions is supplied in the Supervisor 
and I/O Macros publication. 



A problem program can perform I/O opera- 
tions in two ways: 

1. The problem program can issue physical 
I/O macro instructions directly. 

2. The problem program can use logical 
IOCS, which in turn issues the physical 
I/O macro instructions. 



Physical I/O Macro Instructions 



The physical I/O macro instructions are: 

1. EXCP (Execute Channel Program). This 
macro instruction communicates directly 
with the Channel Scheduler to request 
that an I/O operation be started. When 
the EXCP macro instruction is used, the 
problem program must supply the 
appropriate channel program consisting 
of channel command words (CCW's). 

2. WAIT. This macro instruction suspends 
program operation until an I/O opetra- 
tion (referenced in the WAIT macro 
instruction) is complete. The problem 
program must use this macro instruction 
at the point where processing cannot 
proceed iintil the I/O operation is 
complete. For instance, a problem 
program may issue the EXCP macro 
instruction to read a tape block. At 
the point where the program needs the 
block for processing, a WAIT macro 
instruction must be issued. The 
instructions generated from this macro 
simply loop, testing a program switch 
to see if the operation has been com- 
pleted. The completion of the opera- 
tion causes an I/O interruption to the 
Channel Scheduler. Before control is 
returned to the wait loop, the switch 
is set to show the completion. Thus, 
the next time it is tested, the loop is 
broken and processing continues. 

3. CCB (Command Control Block). This 
declarative macro instruction generates 
a command control block for each list 
of CCW's to be executed. The comnjand 
control block contains information 
required by the Channel Scheduler to 
execute the EXCP and WAIT macro 



DEVICE ERROR RECOVERY 



Each I/O device or class of I/O devices has 
a unique device error recovery routine. 
The appropriate routine is entered from the 
Channel Scheduler upon detection of an 
error. All these routines have one func- 
tion in common. That is, an attempt is 
made to recover from the error. This may 
be by programming (re-reading tape) or by 
operator action (25U0 not ready). 

If recovery is not possible, the follow- 
ing choices are available where applicable. 

1. The record in error can be bypassed. 

2. An error on an input record can be 
ignored. 

3. The problem program can take action (an 
exit to a user routine is allowed) . 

4. The job can be terminated. 

Depending on the type of device and on 
whether logical IOCS is used, some or all 
of the above options are available. In the 
absence of any other options, only choice U 
is available. 



OPERATOR COMMUNICATION 



Communication with the operator is through 
use of full-text messages issued via the 
IBM 1052 Printer-Keyboard. Two-way com- 
munication is possible: from the system to 
the operator and from the operator to the 
system. 

The Supervisor permits: 

1. Full-text messages to the operator. 
These messages are either information 
only or indications of required opera- 
tor action. 

2. Operator- initiated instructions to the 
Supervisor. 

3. Response from the operator to the prob- 
lem program. 
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COMMUNICATION TO THE OPERATOR 



The control program communicates with the 
operator by issuing messages. Each message 
will be preceded by an action indicator 
that may require a reply from the operator 
before processing can continue. 

The message is printed on the IBM 1052 
Printer-Keyboard. If no response is 
required, an I indicator is included in the 
message and processing continues. If a 
reply is required, an action indicator A or 
D is included in the message. The Supervi- 
sor waits until the operator keys in a 
response. 

Each system-to-operator message consists 
of a four-character message code, a one- 
character operator action indicator, at 
least one blank, and the message itself. 
The action indicator specifies the type of 
operator action required. The message 
contains all information pertaining to the 
operator's decision and/or actions. 

The action indicators are as follows. 

In dicator Meaning 

A Action: The operator must per- 
form a specific manual 
action before continu- 
ing. An example of 
this is the mounting of 
a magnetic tape. 

D Decision: The operator must make 
a choice between alter- 
nate courses of action. 

I Information: The message does not 

require immediate oper- 
ator action. For exam- 
ple, this type of mes- 
sage can be used to 
indicate the termina- 
tion of a problem pro- 
gram. 



COMMUNICATION FROM THE OPERATOR 



Once a command has been processed, the 
printer-keyboard is unlocked to permit the 
issuing of further messages. 

Each operator-to-system command consists 
of two parts. The first part is an opera- 
tion code of from one to eight alphabetic 
characters describing the action to be 
taken. Separated from the operation code 
by at least one blank are any necessary 
parameters. The parameters are separated 
by commas. The command ends with an end- 
of-block ( (D= Alter Code 5). See End-of- 
Communi cation Command . 

In order that processing continue, an 
end- of -communications command consisting of 
only ® must be given by the operator 
following the last command. 

With the exceptions of CANCEL and PAUSE, 
operator-to-system commands are accepted 
only between job steps. Operator-to-system 
commands are recognized on SYSRDR. 

There are three types of operator-to- 
system commands . 

1. I/O commands 

2. Job Control commands 

3. Information commands. 



I/O Commands 



There are six I/O commands: ASSGN (assign 
logical name), CLOSE (close system output 
unit) , DVCDN (device down) , DVCUP (device 
up) , MTC (magnetic tape control) , and RESET 
(reset I/O device assignments). 

ASSGN — Assign Logical Name ; The ASSGN 
command is used to assign a logical I/O 
unit to a physical device. 

r T 1 

I Oper- I I 

I a ti on 1 Ope rand | 

|. 1 ^ 

I ASSGN iSYSxxx, address [,X'ss'] [,ALT] [,TEMP] j 

L X J 



The operator may enter a command to the 
system via the 1052 Printer-Keyboard in any 
of the following instances. 

1. The operator has requested it by press- 
ing the rec[uest key. 

2. The system has requested operator 
response. 

3. The progranmier has requested operator 
response with a PAUSE statement. 



The entries in the operand field represent 
the following. 



SYSxxx 



The symbolic unit name. It 
may be one of the following 

SYSRDR 

SYSIPT 

SYSPCH 

SYSLST 

SYSLOG 

SYSRLB 

SYSSLB 

SYS000-SYS244 
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address Can be expressed as X'cuu', 
UA, or IGN. 

X'cuu' — Indicates the channel 
and unit number (in 
hexadecimal) . 
c = for multiplexor 
channel, 1-6 for 
selector channels 
1-6 
uu = 00 to FE (0 to 254) 
in hexadecimal 
UA — Indicates the logical unit 

is to be unassigned. 
IGN — Indicates the logical 

unit is to be unassigned 
and that all program 
references to the logical 
device are to be ignored. 



The entry SYSxxx can be SYSLST, SYSPCH, or 
SYSOOO to SYS244. 

DVCDN — Device Down Command ; The DVCDN 
command is used to inform the system that a 
device is no longer physically available 
for system operations. 

r T 1 

I Operation | Operand | 
|. 1 ^ 

I DVCDN I X'cuu' I 

L ± J 

The entry X'cuu' is expressed in hexa- 
decimal form, where c is the channel number 
(0-6) and uu is the unit number, OO-FE 
(0-254) in hexadecimal. 



X'ss' Device specifications (used for 
seven-track tape) . The specifi- 
cations are: 



DVCUP — Device Up Command ; The DVCUP com- 
mand is used to inform the system that a 
device is available for system operations 
after the device has been down. 





Bytes 




Trans- 






per 




late 


Convert 


ss 


Inch 


Parity 


Feature 


Feature 


10 


200 


odd 


off 


on 


20 


200 


even 


off 


off 


28 


200 


even 


on 


off 


30 


200 


odd 


off 


off 


38 


200 


odd 


on 


off 


50 


556 


odd 


off 


on 


60 


556 


even 


off 


off 


68 


556 


even 


on 


off 


70 


556 


odd 


off 


off 


78 


556 


odd 


on 


off 


90 


800 


odd 


off 


on 


AO 


800 


even 


off 


off 


A8 


800 


even 


on 


off 


BO 


800 


odd 


off 


off 


B8 


800 


odd 


on 


off 



ALT Indicates an alternate mag- 

netic tape unit that is used 
when the capacity of the 
original assignment is 
reached. 

TEMP Indicates the assignment for 

the logical unit will be 
destroyed by the next JOB 
statement. Unless this 
option is taken, the assign- 
ment made is carried from 
job to job. 

CLOSE — Close System Output Unit Command ; 
The CLOSE command is used to close a work- 
file on the unit designated in the operand 
field. 



r T 1 

I Operation | Operand | 
|. + ^ 

I DVCUP I X'cuu' I 

L J. J 

The entry X'cuu' is expressed in hexa- 
decimal form, where c is the channel number 
(0-6) and uu is the unit number, OO-FE 
(0-254) in hexadecimal. 

MTC -- Magnetic Tape Control Command ; The 
MTC command is used to control magnetic 
tape operations. The first entry in the 
operand field specifies the operation to be 
performed. 

r T 1 

I Operation | Operand | 
y 4 ^ 

I MTC I opcode,X'cuu' I 
L X J 

The first entry in the operand field can 
be; 



Opcode 


Meaning 


BSF 


Backspace file 


BSR 


Backspace record 


ERG 


Erase gap 


FSF 


Forward space file 


FSR 


Forward space record 


RUN 


Rewind and unload 


REW 


Rewind 


WTM 


Write tape mark 



The second entry X'cuu' is expressed in 
hexadecimal form, where c is the channel 
number (0-6) and uu is the unit number, 
OO-FE (0-254) in hexadecimal. 



r T -1 

I Operation | Operand | 
^ 1 ^ 

(close I SYSxxx I 

L X _J 



RESET — Reset I/O Assignments Command ; The 
RESET command is used to reset I/O assign- 
ments to the standard assignments. The 
standard assignments are those specified 
when the system was generated plus any 
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modifications made by the operator via an 
ASSGN command (without the TEMP option) . 



J. ^ ^ 

I Operation | Operand | 

I RESET I blank | 
L L J 

The operand field is ignored by the system. 



r 

1 Operation 
j. 


"T- 

1 


1 

Operand | 
^ 

'"SYS "^ 1 
PROG 1 


1 LISTIO 


1 < 


UA ) 1 

DOWN I 1 

^SYSxxxJ 1 


u 


1 


J 



Job Control Commands 



There are two Job Control commands; 
(cancel job) and PAUSE (pause) . 



CANCEL 



CANCEL — Cancel Job Command; The CANCEL 
command is used to cancel the execution of 
the current job. The command is acceptable 
at any time and cancellation is immediate. 



J. ^ ^ 

I Operation | Operand | 

[CANCEL I blank | 
L J. J 

PAUSE -- Pause Command; The PAUSE command 
is used to cause Job Control processing to 
pause between job steps. At that time, the 
printer-keyboard is unlocked for message 
input. The end-of -communications indica- 
tion B causes processing to continue. 



r • — T 1 

[Operation | Operand | 

|. 1 . ^ 

I PAUSE I [any user comment] | 

L L J 



If the operand SYS is specified, the list- 
ing includes all system logical units. If 
the operand PROG is specified, the listing 
includes all programmer logical units. If 
the operand UA is specified, the listing 
includes all unassigned physical devices. 
If the operand DOWN is specified, the list- 
ing includes all physical devices that are 
inoperative. If the operand SYSxxx is 
specified, where SYSxxx is either a system 
or programmer logical unit, the listing 
shows only the assignment for unit SYSxxx. 

LOG — Log Command; The LOG command is 
used to cause the system to log all Job 
Control statements on SYSLOG until a NOLOG 
command is sensed. 



r T 1 

I Operation | Operand | 
J. 1 ^ 

I LOG I blank | 

L J. J 



The operand field is ignored by the system. 

NOLOG -- Suppress Logging Command; The 
NOLOG command is used to cause the system 
to suppress the logging of all Job Control 
statements except JOB, PAUSE, *, and /6 
until a LOG command is sensed. 



The operand of the PAUSE message is not 
processed by the system. It is used only 
for operator documentation. A pause com- 
mand can be issued at any time. 



r T ^ 

[Operation | Operand | 
j. 1 ^ 

I NOLOG I blank j 
L X J 



Information Comraands 



There are five information commands: LISTIO 
(list I/O assignments), LOG (log Job Con- 
trol statements), NOLOG (suppress logging), 
SET (set value), and (§) (end of 
communications) .. 

LISTIO — List I/O Assignment Command ; The 
LISTIO command is used to cause the system 
to print a listing of I/O assignments. The 
listing appears on the printer-keyboard 
( SYSLOG ) . 



The operand field is ignored by the system. 

SET — Set Value Command; The SET command 
is used to initialize the date, clock, and 
UPSI configuration for system operations. 
The SET command is used primarily during 
the IPL procedure. 



r T 1 

lOper- I I 

|ation I Operand | 

1- + ^ 

I SET I [DATE=nl ] [ , CL0CK=n2 ] [ , UPSI=n3 ] 1 
I I [,LINECT=n4] I 

L J. J 
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The entries in the operand field rep- 
resent the following. 



DATE=nl 



CL0CK=n2 



UPSI=n3 



Sets the system date perman- 
ently to the specified 
value. nl has one of the 
following formats: 



mm/dd/yy 
dd/mm/yy 



mm specifies the month; dd 
specifies the day; ^1 speci- 
fies the year. The format 
to be used is the format 
that was selected when the 
system was generated. 



Sets the system clock to the 
specified value. n2 has the 
following format. 



hh/mm/ss 

hh specifies hours (00-23); 
mm specifies minutes 
(00-59); ss specifies sec- 
onds (00-59). 

Sets the bit configuration 
of the UPS I byte in the com- 
munication region. n3 con- 
sists of one to eight 
digits, either 0, 1, or X. 
Positions containing will 
be set to 0; positions con- 
taining 1 will be set to 1; 
positions containing X will 
be unchanged. Unspecified 
rightmost positions are 
assumed to be X. 



SYSTEM OPERATION WITHOUT A 1052 



When a 1052 is not available on the system, 
a printer must be assigned to SYSLOG. Mes- 
sages to the operator are printed on SYS- 
LOG, after which an assumed operator 
response, where applicable, is taken. In 
most cases, the assumed response results in 
the termination of the job. There is no 
communication from the operator, except for 
I/O device error routines which require 
operator-stored response in low main stor- 
age. In such cases, a message is printed 
on the printer assigned to SYSLOG and the 
device error routines wait until the opera- 
tor stores his response and presses the 
console interrupt key. PAUSE statements in 
the Job Control input stream are ignored. 



An operational 1052 is required on the 
system if external interrupt support is 
indicated when the system is generated. 



In addition to the requirement that 
SYSLOG be assigned to a printer, SYSRDR and 
SYSIPT must each be assigned to a card 
reader (may be the same card reader) , 
SYSPCH must be assigned to a card punch, 
and SYSLST must be assigned to a printer. 
If SYSLOG and SYSLST are assigned to the 
same printer, system-to-operator messages 
may be embedded within user output. 



When no 1052 is available, total 
throughput in the individual installation 
will suffer, due to the frequent cancella- 
tion of jobs resulting from errors, such as 
incorrect job setup, I/O assignments, etc. 
In many instances, such errors could be 
corrected by the operator via the 1052. 



LINECT=nU Sets the standard number of 
lines to be printed on each 
page of SYSLST. nU is an 
integer. 



SYSTEM LOADER 



( g) — End-of -Communication Command; The 
end-of- communications command must be 
issued whenever the operator is finished 
communicating with the system. It causes 
the communications routine to return con- 
trol to the mainline job. 

r T 1 

I Operation [Operand | 
j. + -I 

I d) 1 Blank 1 
L X J 

(g) is the end-of- block character, alter code 
5. 



The System Loader is a permanently core- 
resident routine in the Supervisor. It 
loads all programs run in the Basic Operat- 
ing System/360 environment, with the excep- 
tion of the core-resident Supervisor 
itself . 

Programs are loaded into main storage 
from the core image library if they are 
cataloged as permanent programs in the core 
image library, or from SYSOOO if the pro- 
gram has been linkage- edited just prior to 
execution. The FETCH and LOAD macro 
instructions explicitly name the phase to 
be loaded. 
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FETCH Macro Instruction 



This macro instruction has the format: 

r T T 1 

I Name ( Operation) Operand | 

j. + 1 ^ 

I [name] | FETCH | phasenameE , entry name] | 

L J. L J 

This macro loads the routine (named by 
phasename) into the problem program area 
and transfers control to the entry point 
specified (entryname) . If no entry point 
is specified, control passes to the entry 
point specified by the Linkage Editor., 



LOAD Macro Instruction 



malfunction such as a power failure may 
occur and cause such an interruption. If 
checkpoint records are written periodical- 
ly, operation can be restarted using a set 
of checkpoint records written prior to the 
interruption. Therefore, the records con- 
tain everything needed to re- initialize the 
system when processing is restarted. 

The Basic Operating System/360 includes 
routines to take checkpoint records and to 
restart a job at a given checkpoint. The 
checkpoint and restart routines are includ- 
ed in the core image library when the sys- 
tem is generated. The CHKPT routine is 
considered part of the Supervisor and is 
executed in the transient area. The 
checkpoint routine is called in response to 
a CHKPT macro instruction in the problem 
program. The restart routine is called by 
Job Control when it reads a RSTRT control 
statement. 



This macro instruction has the format; 



r T T 1 

I Name | Operation | Operand | 

y 1 ^ ^ 

I [name] I LOAD | phasename [, address] | 
L X J. J 



Checkpoint records are written on mag- 
netic tape. Each checkpoint is uniquely 
identified. When restarting, the RSTRT 
control statement specifies which check- 
point is to be loaded. 



This macro instruction is used when a 
phase (named by phasename) is to be loaded 
into main storage, but not executed immedi- 
ately. It can be used to load tables and 
reference material. After the phase is 
loaded, control is returned to the calling 
program with the entry point of the newly 
loaded phase in register 1. This entry 
point is specified by the Linkage Editor. 
If the optional address parameter is speci- 
fied, then the phase is loaded at that 
address, disregarding the load point indi- 
cated by the Linkage Editor. If the 
address differs from that provided by the 
Linkage Editor, no relocation of address 
constants within the program is provided. 



CHECKPOINT/RESTART 



CHKPT Macro Instruction 



Checkpoint can be executed as often as 
desired. The CHKPT macro instruction has 
the format. 



r r T 1 

I |Oper-| I 

I Name | ation| Operand | 

|. 1 1 ^ 

I [ name ] | CHKPT | S YSxxx , prgadr , endadr [ , point ] | 

L X X * . J 

where : 

SYSxxx is the symbolic name of the unit on 
which the checkpoint information is 
to be stored. 



When a problem program is expected to run 
for an extended period of time, provision 
should be made for taking checkpoint 
records periodically during the run. The 
records contain the status of the job and 
system at the tin>e the records are written. 
Thus, they provide a means of restarting at 
some midway point rather than at the begin- 
ning of the entire job, if processing must 
be terminated for any reason prior to the 
normal end of job. Any programmer logical 
unit (SYS000-SYS244) can be checkpointed. 

For example, a job of higher priority 
may require immediate processing or some 



prgadr is the restart address. 

endadr is uppermost byte of problem program 
area required to restart the pro- 
gram. 

point is the name of an 8-byte field. This 
parameter is required only if tapes 
are to be repositioned at restart. 

A detailed explanation of the CHKPT macro 
instruction will be found in the Supervisor 
and I/O Macros publication. 

The restart facility is described in the 
section on Job Control. 
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LABEL CHECKING 



All label checking is performed by tran- 
sient routines of the Supervisor. These 
routines are called into the transient area 
and executed in response to macro instruc- 
tions issued by the problem program. Since 
these routines do not occupy space that can 
be used by the problem program, there is no 
need to handle OPEN and CLOSE operations as 
overlays in special phases. 



NORMAL AND ABNORMAL END- OF- JOB HANDLING 



to begin processing the control statements 
for the next job or job step. 



A special routine of the Supervisor can 
provide a print-out of main storage in the 
event of some abnormal end-of- job-step 
situation. This routine is fetched into 
the transient area when a dump is -required 
and when DUMP is specified as a standard 
option at system generation time or when 
DUMP is specified in the OPTION control 
statement. The dump routine prints the 
contents of the registers and main storage 
from location to the end of the problem 
program area. 



When a program reaches the normal end of a 
job step, issuing the EOJ macro instruction 
causes the Supervisor to fetch Job Control 
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JOB CONTROL 



The Job Control program provides job-to- job 
transition within the Basic Operating 
System/360. It also is called into main 
storage to prepare each job step to be run. 
(One or more programs can be executed with- 
in a single job. Each such execution is 
called a job step . ) It performs its func- 
tions between job steps and is not present 
while a problem program is being executed. 
Job Control is called by: 

1.. The IPL Loader, to process the first 
job after an IPL procedure. 

2.. The Supervisor, at normal end of a job 
step, or at an abnormal end of job. 

A macro instruction, EOJ, is provided to 
call Job Control for a normal end of a job 
step. 



FUNCTIONS 



Job Control performs various functions on 
the basis of information provided in job 
control statements. These functions are: 

1. Prepare programs for execution. 

2. Assign device addresses to symbolic 
names. 

3. Set up fields in the communication 
region. 

U. Edit and store volume and file label 
information. 

5. Prepare for restarting of checkpointed 
programs. 

Job Control clears the problem program area 
in main storage to binary zero between job 
steps. 



PREPARE PROGRAMS FOR EXECUTION 



All programs run in the system are loaded 
from either the core image library or from 
SYS 000. If a program has been previously 
cataloged (see Librarian) as a permanent 
entry in the core image library. Job Con- 
trol has only to transfer to the system 
loader to load the program for execution 
from the core image library. If the pro- 
gram to be executed is on SYSOOO, it will 



have had all linkages resolved by the Lin- 
kage Editor (see Linkage Editor ) . Job 
Control transfers to the system loader to 
load the program for execution directly 
from SYSOOO. 



SYMBOLIC INPUT/OUTPUT ASSIGNMENT 



Job Control is responsible for assigning 
physical I/O units. Programs do not ref- 
erence I/O devices by their actual physical 
addresses, but rather by symbolic names. 
The ability to reference an I/O device by a 
symbolic name rather than a physical 
address provides advantages to both pro- 
grammers and machine operators. The sym- 
bolic name of a device is chosen by the 
programmer from a fixed set of symbolic 
names. He can write a program that is 
dependent only on the device type and not 
on the actual device address. At execution 
time, the operator or programmer determines 
the actual physical device to be assigned 
to a given symbolic name. He communicates 
this to Job Control by a control statement 
(ASSGN) . Job Control associates the physi- 
cal device with the symbolic name by which 
it is referenced. 

A fixed set of symbolic names is used to 
reference I/O devices. No other names can 
be used. They are: 



SYSRDR 



SYSIPT 



SYSPCH 



SYSLST 



SYSLOG 



SYSRES 
SYSSLB 



Card reader or magnetic tape 
unit used for Job Control 
statements . 

Card reader or magnetic tape 
unit used as the input unit 
for programs. 

Card punch or magnetic tape 
unit used as the main unit 
for punched output. 

Printer or magnetic tape 
unit used as the main unit 
for printed output. 

Printer-keyboard used for 
operator messages and to log 
Job Control statements. Can 
also be assigned to a prin- 
ter. 

System residence tape unit. 

Tape unit used for the 
source statement library. 
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SYSRDR I SYSIPT | SYSPChTsYSLST | SYSLOG | SYSRES | SYSSLB | SYSRLB I Reserved I SYSOOO | SYSOoT[ 7^ | SYS244 



Pointer to 


Pointer to Job 


PUB 


Information 




Block 



number of units specified 
when assembling Supervisor 



-2 bytes- 



Figure 5. Sequence of LUB's in Device Table 



Channel 


Unit 


Pointer to 

Channel 

Queue 


Pointer to 
Tape Error 
Block 


Device Type 


Device Options 
{7-Track Tape, 
etc) 


Channel 

Scheduler 

Flags 


Job 

Control 

Flags 



Figure 6. Format of PUB Entry 



SYSRLB 



Tape unit used for the relo- 
catable library. 



SYS00 0-syS24a All other units in the sys- 
tem. 



The first eight of the above names, termed 
system logical units , are used by the sys- 
tem control program and system service 
programs. Of these nine units, user pro- 
grams may also use SYSIPT for input, SYSLST 
and SYPCH for appropriate output, and SYS- 
LOG for operator communication. Normally, 
SYSRDR and SYSIPT both refer to the same 
device. SYSRES, SYSSLB, and SYSRLB can all 
refer to the same device. Any additional 
devices in the system, termed programmer 
logical unit s, are referred to by names 
ranging consecutively from SYSOOO to 
SYS24U, with SYSOOO to SYS003 being the 
minimum provided in any system. 



Logical Unit Block (LUB) and Physical Unit 
Block (PUB) 



At system generation time when a Supervisor 
is assembled, a device table is set up with 
an entry for each of the symbolic names 
that will be used in the system. Each 
entry is called a logical unit block (LUB) . 
The format of the device table is shown in 
Figure 5. The length of the table depends 
on the number of devices specified at sys- 
tem generation time. The system LUB's and 
the first four programmer LUB's are always 
present. 

A physical unit block (PUB) can be asso- 
ciated with each LUB. The format of a PUB 
is shown in Figure 6. The PUB's are 
ordered by priority within the channel to 
which the various devices are attached. 



Normally, each symbolic name is assigned 
a physical device address at the time the 
Supervisor is assembled. In some cases, a 
single device may be assigned to two or 
more symbolic names. An installation can 
make specific assignments at system genera- 
tion time and establish these as conven- 
tions to be followed by all programmers. 
By following the conventions, most jobs can 
be submitted for execution with no ASSGN 
control statements. Figure 7, for example, 
shows a typical system configuration. The 
following conventions might be established 
for the installation's own programs and for 
IBM-supplied programs. 

1. Control statement input is read from 
SYSRDR. This device is normally 
assigned to the same physical unit as 
SYSIPT. Most of the system programs 
(language translators, etc) and user 
programs normally read from SYSIPT. 

2. Card putput is punched on SYSPCH. 

3. Printed output is on SYSLST. 

U. A 1052 is assigned to SYSLOG. 

5. The seven tape units are addressed as 

SYSRES, SYSSLB, SYSRLB, SYSOOO, SYSOOl, 
SYS00 2, and SYS003 . SYSRES is used for 
system residence. SYSSLB is used for 
the source statement library. SYSRLB 
is used for the relocatable library. 
SYSOOO is used by the Linkage Editor 
when performing its editing functions. 
SYSOOl, SYS002, and SYS003 are used by 
the language translators as work files. 
Language translators also can output 
Linkage Editor input on SYSOOO. 

The initial device assignments present 
after each IPL procedure are those made 
when the system is generated plus any chan- 
ges introduced at IPL time. Once the 
Supervisor is loaded into main storage, 
reassignments made by the operator on the 
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1052 become permanent modifications to the 
existing system assignments unless the 
operator specifies temporary assignment, 
Reassignments made by the programmer are 
reinitialized to the original assignments 
at the completion of a job. 



2540 Card 
Read-Punch 



1403 Printer 



SYSRDR, SYSIPT, 
SYSPCH 



SYSLST 



1052 ^ 

Printer- Keyboard J 



f 2402 ^ 



SYSLOG 



SYSRES 




SYSSLB 




2402 

#3 



SYSRLB 




2402 

#4 



SYSOOO 



/^2402 A 



SYSOOl 




SYS002 




SYS003 



Figure 7. Example of Symbolic Device 
Assignment 
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SET UP COMMUNICATION REGION 



Job Control takes the following information 
from control statements and places it in 
the communication region. 

1. Job Name . Taken from the JOB state- 
ment. This field can be used by the 
problem program for accounting purpos- 
es. 

2. Job Date . Taken from the DATE state- 
ment. It can be used by the problem 
program to date output reports. If the 
DATE statement is not used, the system 
uses the date supplied by the operator 
at I PL time. 

3. User Program Switch Indicators . Taken 
from the UPSI statement. The bit pat- 
tern in this byte can be used as switch 
indicators to specify program options. 



EDIT AND STORE LABEL INFORMATION 



All volume and file label processing is 
done during problem program execution. 
However, label information to be checked 
against is read from label statements by 
Job Control and stored in the lower part of 
the problem program area for subsequent 
processing. The formats of the label 
information statements are discussed in 
this section. See the Data Management 
publication for a complete discussion of 
volume and file labels. 



statement as a control statement. They 
must be in columns 1 and 2. At least 
one blank immediately follows the sec- 
ond slash. Exception ; The end-of-job 
statement contains /& in columns 1 and 
2, the end-of-data-f ile statement con- 
tains /* in columns 1 and 2, and the 
comment statement contains * in column 
1 and blank in column 2. 

2. Operation . This describes the type of 
control statement (the operation to be 
performed) . It can be up to eight 
characters long. At least one blank 
follows its last character. 

3. Operand . This may be blank or may 
contain one or more entries separated 
by commas. The last term must be fol- 
lowed by a blank, unless its last char- 
acter is in column 71. 

All control statements are essentially 
free form. Information starts in column 1 
and cannot extend past column 71. Excep- 
tion ; For the file label statement (TPLAB) 
information may not be contained entirely 
in one card image. Any non- blank character 
present in column 72 specifies that infor- 
mation is continued in the following card 
image (continuation statement). Informa- 
tion in the continuation statement begins 
in column 16; columns 1-15 are ignored. 

Job Control continuation statements are 
used only for the label statements (other 
statements are not checked for this 
possibility) . 

Job Control reads from the device iden- 
tified by the symbolic name sysRDR. The 
following statements are recognized: 



RESTARTING PROGRAMS FROM CHECKPOINT 



Job Control prepares the system for 
restarting from a checkpoint by loading the 
restart program which repositions tape 
drives, reinitializes the communication 
region, and stores the information from the 
RSTRT statement. The restart program han- 
dles the actual restarting of the problem 
program. 



JOB CONTROL STATEMENTS 



GENERAL CONTROL STATEMENT FORMAT 



Certain rules must be followed when filling 
out control statements. Job Control state- 
ments conform to these rules. 

1. Name. Two slashes (//) identify the 



Operation 


Meaning 


JOB 


Job name 


EXEC 


Execute program 


ASSGN 


I/O assignments 


RESET 


Reset I/O assignments 


DATE 


Date 


UPSI 


User program switch 




indicators 


NMTLB 


Number of magnetic tape 




label blocks 


VOL 


Volume information 


TPLAB 


Tape file label infor- 




mation 


RSTRT 


Restart 


LISTIO 


List I/O assignments 


OPTION 


Option 


PAUSE 


Pause 


/ + 


End of data file 


/6 


End of job 


* 


Comment 



Any statement other than these is recog- 
nized as an error. A message is issued so 
that the programmer can correct the state- 
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ment in error. Some of the errors recog- 
nized are: 



DESCRIPTION AND FORMAT OF JOB CONTROL 
STATEMENTS 



1. Invalid symbolic unit name. 



JOB Statement 



2. No space reserved in LUB table for a 
symbolic unit. 



3. Invalid device-type. 



4. Invalid length of field. 



This statement indicates the beginning of 
control information for a job. The JOB 
statement is in the following format . 

// JOB jobname 

jobname The name of the job. Must be 
one to eight alphameric charac- 
ters. 



5. Invalid character. 



Missing /6 statement. 



EXEC Statement 



A label statement (TPLAB) does not 
immediately follow its associated vol- 
ume (VOL) statement. 



SEQUENCE OF CONTROL STATEMENTS 



The Job Control statements for a specific 
jo b always begin with a JOB statement and 
end with a /6 (end of job) statement. A 
specific job consists of one or more job 
steps . Each job step is initiated by an 
EXEC statement. Preceding the EXEC state- 
ment are any job control statements neces- 
sary to prepare for the execution of the 
specific job step. The only limitation on 
the sequence of statements preceding the 
EXEC statement is that discussed below for 
the label information statements. The 
following statements can precede the EXEC 
statement for a job step. 

ASSGN 

RESET 

DATE 

UPS I 

NMTLB 

VOL 

TPLAB 

LIST 10 

OPTION 

PAUSE 

* 

The label statements must be in the order: 

VOL 
TPLAB 

and, must immediately precede the EXEC 
statement to which they apply. 



The EXEC (execute) control statement must 
be the last statement processed before a 
job step is executed. It indicates the end 
of job control statements for a job step 
and that execution of a program is to 
begin. Its format is: 

// EXEC [progname] 

progname Represents the name of the 
program in the core image 
library to be executed. The 
program name can be one to 
eight alphameric characters. 
If the program to be executed 
has just been processed by the 
Linkage Editor, the operand of 
the EXEC statement is blank. 



ASSGN Statement 

When programs are assembled, they use sym- 
bolic names to reference I/O devices. At 
execution time this statement is used to 
assign a specific device address to the 
symbolic unit name used. It contains the 
symbolic unit name and various parameters 
to describe the physical device. The for- 
mat is: 

// ASSGN SYSxxx,deviceaddress[,X'ss' ] [,ALT] 

SYSxxx The symbolic unit name. It may 
be one of the following. 
SYSRDR 
SYSIPT 
SYSPCH 
SYSLST 
SYS LOG 
SYSSLB 
SYSRLB 
SYSOOO to SYS24U 
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deviceaddress 



X'ss' 



Can be expressed as X'cuu', 
UA, or IGN. 

X'cuu' — channel and unit 
number (in 
hexadecimal) . 
c = for multiplexor 
channel, 1-6 for 
selector channels 
1-6 
uu = 00 to FE (0 to 254) 
in hexadecimal. 
UA -- indicates the logical 
unit is to be unas- 
signed. 
IGN — indicates the logi- 
cal unit is to be 
unassigned and that 
all program referen- 
ces to the logical 
device are to be 
ignored. 

Device specifications (used 
for seven-track tape) « The 
specifications are: 

Bytes Trans- 
per late convert 
ss Inch Parity Feature Feature 



10 


200 


odd 


off 


on 


20 


200 


even 


off 


off 


28 


200 


even 


on 


off 


30 


200 


odd 


off 


off 


38 


200 


odd 


on 


off 


50 


556 


odd 


off 


on 


60 


556 


even 


off 


off 


68 


556 


even 


on 


off 


70 


556 


odd 


off 


off 


78 


556 


odd 


on 


off 


90 


800 


odd 


off 


on 


AO 


800 


even 


off 


off 


A8 


800 


even 


on 


off 


BO 


800 


odd 


off 


off 


B8 


800 


odd 


on 


off 



ALT Indicates an alternate 

magnetic tape unit that is 
used when the capacity of 
the original assignment is 
reached. 

All device assignments made with ASSGN 
control statements are reset between jobs 
to the configuration specified when the 
system was generated plus any modifications 
that may have been made by the operator at 
IPL time and between jobs or job steps. 



RESET Statement 



The RESET statement is used to reset I/O 
assignments to the standard assignments. 
Its format is: 



// RESET 



The standard assignments are those speci- 
fied when the system is generated plus any 
modifications made by the operator via an 
ASSGN command (as opposed to an ASSGN con- 
trol statement) without the TEMP option. 



DATE Statement 



This statement contains a date which is put 
in the communication region. It is in one 
of the following formats: 

// DATE mm/dd/yy 
// DATE dd/mm/yy 

mm = Month (01 to 12) 
dd = Day (01 to 31) 
yy = Year (00 to 99) 

When the DATE statement is used, it 
applies only to the current job being exe- 
cuted. Job Control does not check the 
order that the digits appear in the oper- 
and. If no DATE statement is used. Job 
Control supplies the date given in the last 
SET command. 



UP SI Statement 



This statement (User Program Switch 
Indicators) allows the user to set program 
switches that can be tested much the same 
as sense switches or lights used on other 
machines. The UPSI statement has the fol- 
lowing format. 

// UPSI nnnnnnnn 

The operand consists of one to eight 
characters of 0, 1, or X. Positions con- 
taining will be set to 0. Positions 
containing 1 will be set to 1. Positions 
containing X will be unchanged. Unspeci- 
fied rightmost positions are assumed to be 
X. 

Job Control clears the UPSI byte to 
zeros before reading control statements for 
each job. When Job Control reads the UPSI 
statement, it sets or ignores the bits of 
the UPSI byte in the communication region. 
Left to right in the UPSI statement, the 
digits correspond to bits through 7 in 
the UPSI byte. Any combination of the 
eight bits may be tested by problem pro- 
grams at execution time. 
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NMTLB Statement 



The NMTLB statement directs the Linkage 
Editor to reserve a portion of the lower 
problem program area as a label block area. 
The NMTLB statement must precede the EXEC 
LNKEDT statement. The format is: 

// NMTLB nnn 

where nnn is the decimal number of pairs of 
VOL/TPLAB statements that will appear 
immediately prior to the execution of the 
linkage edited program. 



V OL Statement 

The volume statement is used when checking 
or writing standard labels for a tape file. 
A VOL statement must be used for each file 
on a multi-file volume. Its format is: 

// VOL SYSxxx, filename 

SYSxxx Symbolic unit name. 

filename File name. This can be one to 

eight characters and is identical 
to the symbolic address of the 
program DTF which identifies the 
file. 



label fields 11-13 



contained within 
single quotes. The 
standard tape file 
label is shown in 
Appendix A. 

These fields are a 
20-character direct 
continuation of the 
same character 
string begun with 
fields 3-10 (no 
blanks , quotes , or 
commas separating) . 
These fields are not 
required. If 
intended for an 
output file, they 
are written in the 
corresponding fields 
of the output label. 
They are ignored 
when used for an 
input file. These 
fields are never 
used by the Basic 
Operating Sys- 
tem/360 label pro- 
cessing routines. 
They can be entered 
in labels for files 
that are to be pro- 
cessed by Operating 
System/360. 



TPLAB Statement 



RSTRT Statement 



The tape-label statement contains file 
label information for tape label checking 
and writing. This statement must immedi- 
ately follow the volume (VOL) statement. 
Tape file labels normally require only one 
statement. This contains fields 3-10 of 
the standard tape file label. These are 
the only fields used for checking the label 
of an input file. When writing output 
labels, the additional fields (11-13) can 
be included, if desired, by continuing the 
TPLAB statement in a continuation state- 
ment. Thus, the TPLAB statement may have 
either of the following two formats. 

// TPLAB 'label fields 3-10' 

// TPLAB 'label fields 3-10 C 
label fields 11-13' 



•label fields 3-10' 



The indicated fields 
of the standard tape 
file label are con- 
tained just as they 
appear in the label. 
This is a 49-byte 
character string. 



A restart facility is available for check- 
pointed programs. A programmer can use the 
CHKPT macro instruction in his program to 
cause checkpoint records to be written. 
This allows sufficient information to be 
stored so that program execution can be 
restarted a specified point. The check- 
pointed information includes the registers, 
tape-positioning information, a dump of 
main storage, and a restart address. 

The restart facility allows the pro- 
grammer to continue execution of an inter- 
rupted job at a point other than the begin- 
ning. The procedure is to submit a group 
of job control statements including a 
restart (RSTRT) statement. The format of 
the RSTRT statement follows. 

// RSTRT SYSxxx, nnnn 

SYSxxx Symbolic unit name of the device 
on which the checkpoint records 
are stored. This unit must have 
been previously assigned. 

nnnn Identification of the checkpoint 
record to be used for restart- 
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ing. This serial number is one 
to four characters. It corres- 
ponds to the checkpoint iden- 
tification used when the 
checkpoint was taken. The seri- 
al number is supplied by the 
checkpoint routine. 



See the Supervisor and I/O macros publi- 
cation for further details on the CHKPT 
macro instruction. 



When a checkpoint is taken, the complet- 
ed checkpoint is noted on SYSLOG. Restart- 
ing can be done from any checkpoint record, 
not just the last. The proper I/O device 
assignments must precede the RSTRT control 
statement. 



LISTIO SYS 




I/O UNITS 


:H. UNIT 


«»* SYSTEM 


*** 


SYSRES 


1 00 


SYSLOG 


IF 


SYSRDR 


OU 


SYSIPT 


2 01 


SYSLST 


2 02 


SYSPCH 


IGN 


SYSSLB 


UA 


SYSRLB 


1 02 



Figure 8. Example of LISTIO SYS Output 



OPTION Statement 



Assignment of input/output devices to 
symbolic unit names may vary from the ini- 
tial assignment. Assignments are made for 
restarting jobs in the same manner as 
assignments are made for normal jobs. 



LISTIO Statement 



This statement is used to get a listing of 
I/O assignments. Its format is: 

'SYS 
PROG 
// LISTIO < UA 

DOWN 
SYSXXX^ 



The listing is output on the device 
assigned to SYSLST. The listing varies 
according to the operand used. If the 
operand SYS is specified, the listing 
includes all system logical units. If the 
operand PROG is specified, the listing 
includes all programmer logical units. If 
the operand UA is specified, the listing 
includes all unassigned physical devices. 
If the operand DOWN is specified, the list- 
ing includes all physical devices that are 
inoperative. If the operand SYSxxx is 
specified where SYSxxx is either a system 
or programmer logical unit, the listing 
shows only the assignment for unit SYSxxx. 
An example of a listing produced by the 
LISTIO SYS statement is shown in Figure 8. 
All channel and unit numbers are represent- 
ed in hexadecimal. 



This statement is used to specify one or 
more of the Job Control options. The for- 
mat of the OPTION statement is: 

// OPTION optionl[,option2, . . . ] 

The options that can appear in the oper- 
and field are as follows. Selected options 
can be in any order. 



LOG 



NO LOG 



DUMP 



NODUMP 
LINK 



NOLINK 



Causes the listing of all con- 
trol statements on SYSLST. Con- 
trol statements are not listed 
until a LOG option is encoun- 
tered. Once a LOG option state- 
ment is read, logging continues 
from job-step to job-step until 
a NOLOG option is encountered or 
until the JOB control statement 
is encountered. 

Suppresses the listing of all 
control statements on SYSLST 
except JOB, PAUSE, *, and LOG 
option statements until a LOG 
option is encountered. 

Causes a dump of the registers 
and main storage to be output on 
SYSLST in the case of an abnor- 
mal program end (cancel or pro- 
gram check) . 

Suppresses the DUMP option. 

Indicates the problem is to be 
linkage-edited immediately after 
compilation or assembly. When 
the LINK option is used, the 
output of the language transla- 
tors is written on SYSOOO. A 
linkage editor run is then per- 
formed to linkage-edit the out- 
put of the language translators . 

Suppresses the LINK option. The 
language translators can also 
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DECK 

NOD EC K 
LIST 

NOLIST 
LISTX 

NOLISTX 
SYM 

NOSYM 
XREF 

NOXREF 
ERRS 

NOERRS 
CATAL 



U8C 



60C 



suppress the LINK option if the 
problem program contains an 
error that would preclude the 
successful execution of the 
problem program. 

Causes language translators to 
output object modules on SYSPCH. 
If LINK is specified, the DECK 
option is ignored. 

Suppresses the DECK option. 

Causes language translators to 
write the source module listing 
on SYSLST. 

Suppresses the LIST option. 

Causes language translators to 
write the hexadecimal object 
module listing on SYSLST. 

Suppresses the LISTX option. 

Causes the Assembler to output 
the symbol table on SYSLST 
and/or SYSPCH. 

Suppresses the SYM option. 

Causes the Assembler to write 
the symbolic cross-reference 
list on SYSLST. 

Suppresses the XREF option. 

Causes the language translators 
to summarize all errors in the 
source program on SYSLST. 

Suppresses the ERRS option. 

Causes the cataloging of a phase 
or program in the core image 
library at the completion of a 
Linkage Editor run by calling 
the MAINT librarian program. 
CATAL also causes the LINK 
option to be set. 

Specifies the 48-character set 
on SYSIPT. 

Specifies the 60-character set 
on SYSIPT. 



options are also cancelled after each 
occurrence of an EXEC statement with a 
blank operand. 

Note ; The LOG and NOLOG control state- 
ments defined for Basic Programming Support 
(8K Tape) and Basic Operating System (8K 
Disk) are recognized by Job Control as 
equivalent to the LOG and NOLOG options. 



PAUSE Statement 

This statement has the following format. 

// PAUSE [comments] 

Comments Optional. Any message to the 

operator can appear in the oper- 
and of a PAUSE statement. 

The statement can be used to allow for 
the operator action between job steps. 

The printer-keyboard is unlocked for 
operator-message input. The 
end- of- communications indication, (b) , 
causes processing to continue. The PAUSE 
statement is always printed on SYSLOG. If 
no 10 52 is available, the PAUSE statement 
is ignored. 



/+ — End of Data File Statement 



This statement must be the last statement 
of each input data file on SYSRDR and 
SYSIPT. Its format is: 

/♦ ignored 

Columns 1 and 2 are the only columns 
that are checked. /♦ causes the Channel 
Scheduler to post the end-of-file indicator 
in the user's CCB. 



/6 — End of Job Statement 



The options specified in the OPTION 
statement remain in effect until a contrary 
option is encountered or until a JOB con- 
trol statement is read. In the latter 
case, the options are reset to the standard 
that was established when the system was 
originally generated. 

Any assignment for SYSOOO after the 
occurrence of the OPTION statement cancels 
the LINK and CATAL options. These two 



This statement must be the last statement 
of each job . Its format is: 

/S ignored 

Columns 1 and 2 contain a slash and an 
ampersand (12-punch) . Upon occurrence of 
/6 , the Channel Scheduler posts an end-of- 
file indicator in the user's CCB. If the 
user attempts to read past the /£, the job 
is terminated. 
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* — Comments Statement 



CLOSE System Output Files 



♦ any user comments 

Column 1 contains an asterisk, column 2 
is blank. The remainder of the statement 
contains any user comments. The content of 
the comment statement is printed on SYSLOG. 
If followed by a PAUSE statement, the 
statement can be used to request operator 
action. 



As the system does not provide for 
generating multi-reel system output files, 
the units SYSLST and SYSPCH are closed by 
the operator when the limit of their capac- 
ities is near. 



The operator may then mount new volumes 
on these drives, or if enough drives are 
available, they may have been previously 
mounted. The operator then assigns SYSLST 
and SYSPCH to their respecitve tape drives. 



SYSTEM I/O OPERATIONS 



This section describes the opening and 
closing of magnetic tape devices when 
assigned to system logical units, and the 
opening and closing of magnetic tape devi- 
ces when assigned to four programmer logi- 
cal units (SYSOOO - SYS003) used by the 
various system components. 



Processing of input resumes with the 
succeeding job step. The operator should 
not allow the output files to reach the 
limit of their capacities. 



CONTROL STATEMENT EFFECT ON I/O UNITS 



OPEN System Files 



When the system logical unit SYSRDR, 
SYSIPT, SYSPCH, or SYSLST is assigned. Job 
Control checks to seci whether the device 
assignment is to a magnetic tape device. 
If so. Job Control rewinds the tape and 
performs an OPEN having the following char- 
acteristics. 



1. Accepts a leadinc 
or output. 



tape mark for input 



2. Accepts a completely unlabeled tape 
(other than blank tape) for input or 
output, and writes a leading tape mark 
if output. Non-standard labels are not 
recognized. 

3. Accepts an IBM-standard label set 
(including user labels) for input. 

U. Accepts a valid IBM-standard label set 
(including user labels) having a past 
expiration date for output. 

5. Rejects all other volumes by issuing a 
rewind and unload to the drive. An 
error message is printed on the 1052 
(SYSLOG) . The operator can then sub- 
stitute an acceptable volume and re- 
ASSGN from the 1052. 



Certain control statements in the Job Con- 
trol input stream affect the use of system 
I/O units by Job Control. These statements 
are as follows. 



// JOB . When the JOB statement is encoun- 
tered, the content of the statement is 
printed on SYSLOG and SYSLST. If SYSLST is 
assigned to a printer, it is first skipped 
to a new page. If SYSLST is assigned to a 
magnetic tape, a carriage eject character 
is prefixed to the card image, which is 
then written on tape. If SYSPCH is 
assigned to a magnetic tape, two blank card 
images are written on tape. 

/& . When Job Control encounters /& on 
SYSRDR during normal operation, a check is 
made to determine whether SYSIPT is 
assigned to the same physical device. If 
not, SYSIPT is also advanced to /6. 

In the event of an abnormal termination. 
Job Control advances SYSRDR to the next /6, 
and proceeds as above. 

The user should beware of omitting /£, 
for protection of one job from errors in 
the preceding job cannot then be guaran- 
teed. 

Job Control has no responsibility for 
the arrangement of output on any file, 
except that connected with control state- 
ments. Such items as page ejection and 
line count must be managed by the indivi- 
dual processing program. 
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WORK FILES USED BY SYSTEM COMPONENTS 



The four programmer logical units SYSOOO, 
SYSOOl, SYS002, and SYS003 are used as work 
files by the various system components 
(Linkage Editor, Librarian, Language Tran- 
slators, etc). Each must be assigned to a 
teipe unit. The assignment of SYSOOO and 
SYS003 may be to the same tape unit, howev- 
er, when the "compile-and-execute" mode of 
operation is desired, SYSOOO and SYS003 
must be assigned to separate tape units. 

SYSOOO is opened only by Job Control and 
is opened only when OPTION LINK or CATAL is 
encountered. 

The work files SYSOOl, SYS00 2, and 
SYS00 3 are opened and closed by each system 
component that uses them. The programmer 
does not provide label information for 
these work files. 



JOB CONTROL STATEMENT EXAMPLE 



Figure 9 is an example of job control 
statement input (SYSRDR=SYSIPT) required to 
perform a series of job steps in an instal- 
lation using labeled magnetic tape. In the 
discussion that follows, each point corres- 
ponds to the number at the left of the two 
slashes in the job control statements. 

1. JOB statement for the series of job 
steps to be performed. 

2. ASSGN statements that are required for 
the job steps. It is assumed that the 
assignments differ from those specified 
when the system was generated. The new 
assignments will be carried through for 
the entire job and will be reassigned 
at the end of the job to the standards 
established at system generation time. 

3. OPTION statement specifying that the 
output of the assembly will be written 
on SYSOOO for subsequent linkage edit- 
ing. In addition, a listing of the 
source module will be output on SYSLST, 
and the dump option will be exercised 
in the event of an abnormal end of job. 
The DECK option will be overridden by 
the LINK option. 

ii. PHASE and EXEC statements for an assem- 
bly, followed by the Assembler source 
deck and the end-of-data-f ile indicator 
(/♦) , followed by an ENTRY statement. 



5, Number of magnetic tape label blocks 
(NMTLB) statement followed by the EXEC 
statement for the Linkage Editor. The 
NMTLB statement is required to direct 
the Linkage Editor to reserve a portion 
of the lower problem program area as a 
label block area. The Linkage Editor 
edits the object program on SYSOOO and 
writes the edited program back on 
SYSOOO. 



Volxime (VOL) and tape label (TPLAB) 
statements for the object program to be 
executed, followed by the EXEC state- 
ment for the linkage- edited object 
program on SYSOOO. 



7. PAUSE statement that requests operator 
action. 



8. OPTION statement specifying that the 
no-dximp option be exercised. The LINK 
option is included to enable a new 
linkage- edit. 

9. INCLUDE statements for modules in the 
relocatable library that are to be 
included with the object module on 
SYSIPT. A blank operand indicates that 
the module to be included follows on 
SYSIPT, The resulting program is edit- 
ed and written on SYSOOO. 

10. EXEC statement for the program to be 
executed. The data for the execution 
is followed by the end-of-data-f ile 
indicator. 

11. Volume (VOL) and tape label (TPLAB) 
statements for the object program in 
the core image library to be executed, 
followed by the EXEC statement. The 
NMTLB statement is not required when 
the program to be executed is cataloged 
as a permanent entry in the core image 
library. (The NMTLB statement is used 
by the Linkage Editor and immediately 
precedes the EXEC statement for the 
Linkage Editor.) 

12. PAUSE statement that requests operator 
action. 

13. End-of-job indicator. All symbolic 
unit assignments are reset to the 
standards established when the system 
was generated. 

14. JOB statement for the next job. 
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1 


// 


JOB 


EXAMPLE 


2 

L_ 


// 
// 


ASSGN 
ASSGN 


SYS004,X'10r 
SYS005,X'10F' 


3 


// 


OPTION 


LINK, DECK, LIST, DUMP 


- 


t 


PHASE PHSl,ROOT 
// EXEC ASSEMBLY 
(Assembler Source Deck) 

/* 

ENTRY 


r~ 

5 

L 


// 
// 


NMTLB 
EXEC 


2 

LNKEDT 


6 


// 
// 
// 
// 
// 


VOL 

TPLAB 

VOL 

TPLAB 

EXEC 


SYS004,SOURCE 
'label-information' 
SYS005, RESULTS 
'label-information' 


7 


// 


PAUSE 


SAVE SYS004, SYS005, MOUNT NEW TAPES 


8 


// 


OPTION 


NODUMP, LINK 


( 


? 


PHASE PHNAM 
INCLUDE SQRT 
INCLUDE SINE 
INCLUDE 

(Object Deck to be Included) 

/* 

ENTRY 

// EXEC LNKEDT 


r 

10 

L 


// EXEC 

(Data for User Object Program) 

/* 


11 


// 
// 
// 
// 
// 


VOL 

TPLAB 

VOL 

TPLAB 

EXEC 


SYS004, SOURCE 
'label-information' 
SYS005, RESULTS 
'label-information' 
PROGA 


12 


// 


PAUSE 


SAVE SYS004, SYS005, MOUNT NEW TAPES 


13 


/& 






14 


// 


JOB 


NEXT 



Figure 9. Control Statement Example 
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IPL LOADER 



Operation of the IBM Basic Operating 
System/360 is initiated through an initial 
program load (IPL) procedure from the resi- 
dent tape. The operator places the resi- 
dent tape on a drive, selects the address 
of that drive in the load unit switches, 
and presses the load key. This causes the 
first record to be read into main storage 
bytes 0-23. The information read in con- 
sists of an IPL PSW and two CCW's, which in 
turn cause the reading and loading of the . 
IPL Loader. 



Operating in the supervisor state, the 
IPL Loader reads the Supervisor nucleus 
into low main storage. If a read error is 
sensed while reading the Supervisor 
nucleus, the wait state is entered and an 
error code is set in the first word of main 
storage. The IPL procedure must then be 
restarted. 



After successfully reading in the Super- 
visor nucleus, the IPL Loader performs 
these operations. 



1. Sets the LUB table entry for SYSRES to 
point to the PUB entry of the channel 
and unit number of the resident drive. 



2. Places the processing unit in the wait 
state with all interruptions masked 
except the I/O interruption. When the 
wait state is entered, the operator 
decides whether a 1052 or a card reader 
will be used to communicate with the 
system. If a 1052, the attention key 
is pressed; if a card reader, it is 
brought to the ready state. 



3. At this time, the operator has several 
options. He may change the PUB con- 
figuration by adding or deleting a 
device. When a device is deleted, all 
references to it are removed. A device 
may be added only if additional space 
has been made available in the PUB 
table. This is specified as a system 
generation parameter. If a tape is to 
be added, there must also be enough 
space for an associated Tape Error 
Block (TEB) . 

To add a device to the PUB table, a 
control statement, read by the communi- 
cation device (1052 or card reader), in the 
following format is required. 



J. . ^ . ^ 

I Operation | Operand | 

|. 1 __^ 

JADD jx'cuu' [ (k)] ,devicetype[ ,X'ss'] | 

L J. . J 



where: 

X'cuu' = channel and unit numbers. 



k = S if the device is to be 
switchable (the device is 
physically attached to two 
adjacent channels). The 
designated channel is the 
lower of the two channels. 
If the device is not switch- 
able, k = 0-255, indicating 
the priority of the device, 
with indicating the highest 
priority. 

devicetype = actual device (2400, 14U3, 
etc) . 

X'ss' = device specifications (see 
AS5GN Statement ) . Used for 
7- track tapes. If absent, 
X'OO' is assigned. 

To delete a device from the PUB table, a 
control statement, read by the communi- 
cation device (1052 or card reader) , in the 
following format is required. 

r T 1 

I Operation | Operand | 
|. + ^ 

I DEL I X'cuu' I 

L JL J 

where cuu is the channel and unit numbers 
of the device to be deleted. 

U, The only communication required at IPL 
time is the date and, if the timer is 
present, the time of day. It must 
follow any ADD or DEL statements. It 
is entered via the communication device 
(1052 or card reader) and is in the 
following format. 

r ■"■ T 1 

I Operation | Operand | 

j. + ^ 

I SET I DATE=valuel,CL0CK=value2 | 

L . X , J 

valuel Has one of the following 
formats. 



3U 



inm/dd/yy 
dd/nun/yy 

nun specifies the month; dd 
specifies the day; y1 speci- 
fies the year. The format to 
be used is the format that was 
selected when the system was 
generated. 

value2 Has the following format. 

hh/ram/ss 

hh specifies hours; mm speci- 
fies minutes; ^s specifies 
seconds. 



After completing these operations, IPL 
issues the EOJ macro instruction. This, 
macro instruction issues a FETCH for the 
Job Control program, which begins process- 
ing the control statements for the first 
job of the day. Control statements are 
present on the device assigned to SYSRDR. 



If the operator wishes to change any 
symbolic unit assignments, ASSGN statements 
are entered via the communication device 
(1052 or card reader). The ASSGN statement 
is as described in I/O Commands. 
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LINKAGE EDITOR 



All programs executed in the Basic Operat- 
ing System/360 environment must be edited 
by the Linkage Editor. The Linkage Editor 
reads the relocatable output of the lan- 
guage translators and edits it into execu- 
table, non- relocatable programs on SYS 000. 
Once a program has been edited, it can be 
executed from SYSOOO, or it can be catal- 
oged as a permanent entry in the core image 
library. When a program has been cataloged 
in the core image library, the Linkage 
Editor is no longer required for that pro- 
gram. The program is run as a distinct job 
step and is loaded directly from the resi- 
dent tape by the System Loader. 

The extent of the editing function per- 
formed depends on the structure of the 
input program. The simplest case is that 
of a single-module program. The Linkage 
Editor has only to edit the program on 
SYSOOO, creating a single phase entry in 
the core image format. This corresponds to 
the first diagram in Figure 10. 

In more complex situations, the opera- 
tion may involve linking together and relo- 
cating multiple-control sections from sep- 
arate assemblies to produce a number of 
separate phases on SYSOOO (see the last 
diagram in Figure 10). The Linkage Editor 
resolves all linkages (symbolic references) 
between segments of the program and relo- 
cates the phases to load at specified main- 
storage locations. 

To facilitate writing and testing large 
programs, assembled program sections 
cataloged in the relocatable library can be 
combined with other sections from SYSIPT 
(card or tape) . It is advantageous to 
handle some kinds of subroutines in this 
way instead of as macros. 



STAGES OF PROGRAM DEVELOPMENT 



The term program could be confused with 
several things. The programmer codes sets 
of source statements that may be a complete 
program or part of a program. These source 
statements are then compiled or assembled 
into a relocatable machine- language program 
which, in turn, must be edited into an 
executable program, and may be combined 
with other programs. Consequently, it is 
convenient to refer to each stage of pro- 
gram development by a particular name. 



A set of source statements that is proc- 
essed by a language translator (Assembler, 
COBOL, FORTRAN, RPG, or PL/ I) is referred 
to as a source module . 

The output of a language translator is 
referred to as an object module . All 
object modules must be further processed by 
the Linkage Editor before they can be exe- 
cuted in the basic operating system. Note ; 
Each element in the relocatable library is 
called a module. These relocatable modules 
each consist of a single object module. 

The output of the Linkage Editor con- 
sists of one or more program phases in 
SYSOOO. A phase is in executable, non- 
relocatable, core image form. Each 
separate phase is loaded by the System 
Loader in response to a FETCH or LOAD 
macro. 



STRUCTURE OF A PROGRAM 



Source Modules; A source module is input 
to a language translator and consists of 
definitions for one or more control sec- 
tions. When the source module is translat- 
ed, the output (object module) consists of 
one or more defined control sections. Each 
control section is a block of code assigned 
to contiguous main-storage locations. The 
input for building a phase (a section of a 
program loaded as a single overlay) must 
consist of one or more complete control 
sections. 

Object Module; An object module is the 
output of a complete language translator 
run. It consists of control dictionaries 
and text of one or more control sections. 
The control dictionaries contain the infor- 
mation necessary for the Linkage Editor to 
resolve cross references between different 
object modules. The text is the actual 
instructions and data fields of the object 
module. The program cards produced by the 
language translators (as distinct from the 
Linkage Editor control statements to be 
discussed later) have an identifier in 
columns l-U that indicates the content of 
the card. The following card types, except 
REP cards, are produced by the language 
translators: 

Identification Contents or Meaning 

ESD External Symbol Dic- 
tionary 
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SINGLE OBJECT MODULE — SINGLE PHASE 



TXT 
RLD 

REP 
END 



Text 

Relocation Dictionary 

Item 
Replacement Text Record 
End of a Module 



With the exception of REP cards, all these 
cards must be present in an object module 
in the indicated sequence. REP cards, when 
required, appear after the TXT cards and 
before the END card, and are produced by 
the programmer. The format of the REP card 
is described in a latter part of this sec- 
tion. 



PHASE PROGA 




ESD MODA 




TXT CSA 








PHASE PROGA 
CSA 


REP (optional) 


RLD MODA 






END 




ENTRY 




SINGLE OBJECT MODULE - MULTIPLE PHASE 


PHASE PROGA], CSA, C5 B 




PHASE PROGA2, CS C 








PHASE PROGA 1 
CS'sA + B 


ESD MODA 


TXT CSA 








PHASE PROGA2 
CS C 


TXT CS B 


TXT CSC 






REP (optional) 




RLD MODA 




END 




ENTRY 




MULTIPLE OBJECT MODULE — SINGLE PHASE 


PHASE PROGA 




ESD MODA 




TXT CSA 




TXTCSB 






REP (optional) 




PHASE PROGA 
CS'sA+B+C 


RLD MODA 






END 








ESD MODB 




TXT CSC 




REP (optional) 




RLD MODB 




END 




ENTRY 




MULTIPLE OBJECT 


MODULE — MULTIPLE PHASE 


PHASE PROGA 1 




ESD MODA 




TXT CSA 








PHASE PROGA 1 
CS's A + B+C 


TXT CS B 


TXT CSC 




REP (optional) 




PHASE PROGA 2 
CS's D+ E 


RLD MODA 


END 










PHASE PROGA 2 




ESD MODB 




TXTCSD 




TXTCSE 




REP (optional) 




RLD MODB 




END 




ENTRY 





Figure 10 . Linkage Editor Input and Output 
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Program Phase : A program phase , the output 
ol; the Linkage Editor, is that section of a 
program that is loaded as a single overlay 
with a single FETCH or LOAD by the System 
Loader. Programs may consist of many phases, 
the first fetched by Job Control, and each 
of the rest by a preceding program phase. 
Successive phases of a multi-phase program 
are often called overlays . 



The input for building a single phase 
consists of the text from one or more com- 
plete control sections. When building a 
phase, the Linkage Editor constructs a 
composite ESD and a composite PHASE data, 
known as the control dictionary ^ and a 
composite RLD from each of the modules that 
make up the phase. These composite dic- 
tionaries are used to resolve all linkages 
between different control sections as if 
they had been assembled as one module. 
Each control section within the phase is 
relocated as necessary, and the entire 
phase is assigned a contiguous area of main 
storage. All relocatable address constants 
are modified to contain the relocated value 
of their symbols. The Linkage Editor 
always ensures that each phase or control 
section begins on a double-word boundary. 



CATALOG AS PERAAANENT PROGRAM 



Each phase is constructed by building 
the text in a work area and then writing it 
in blocks in SYSOOO. Thus, a phase may 
consist of one or more blocks of contiguous 
core image locations. Backward origin 
within a phase causes slower operation of 
the Linkage Editor. 



TYPES OF LINKAGE EEITOR RUNS 



The Linkage Editor is run as a distinct job 
step. Because of this fact, it is meaning- 
ful to classify it as one of the system 
service programs. The Linkage Editor func- 
tion is performed as a job step in three 
kinds of operations (Figure 11) . 

1. Catalog Programs in Core Image Library . 
The Linkage Editor function is performed 
immediately preceding the Librarian opera- 
tion (MAINT) that catalogs CCATAL option) 
programs as permanent entries in the core 
image library. The sequence of events when 
this operation is performed is shown in the 
first diagram of Figure 11. Note that the 
input for the LNKEDT function could include 
modules from the relocatable library 
instead of, or in addition to, those 




( SYSOOO J / l'';]^°3^ 



Editor 



OPTION CATAL 
PHASE PROGA 

INCLUDE 

ENTRY 

EXEC LNKEDT 




LOAD AND EXECUTE 




-(sy^U So?/H;^J«°4^ 



PHASE 
INCLUDE 

ENTRY 

EXEC LNKEDT 
EXEC 




ASSEMBLE AND EXECUTE 




OPTION LINK 

PHASE 

EXEC ASSEMBLY 

ENTRY 

EXEC LNKEDT 

EXEC 



Figure 11. Three Types of Linkage Editor Operations 
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modules from the card reader or tape unit 
assigned to SYSIPT. This is accomplished 
by including the name of the module to be 
included in an INCLUDE statement. In addi- 
tion, had the LINK option been specified in 
the OPTION control statement, the object 
module output by the language translator 
would have been written directly on SYSOOO. 

2. Load-and-Execute . The sequence of 

events when this operation is performed 
is shown in the second diagram in Fig- 
ure 11. Just as with the catalog oper- 
ation, the input can consist of object 
modules from the relocatable library 
instead of, or in addition to, those 
modules from the card reader or tape 
unit assigned to SYSIPT. This is 
accomplished by including the name of 
the module to be included in the oper- 
and of an INCLUDE statement. After the 
object modules have been edited on 
SYSOOO, the program on SYSOOO is exe- 
cuted. The blank operand in the EXEC 
control statement indicates that the 
program just linkage- edited on SYSOOO 
is to be executed. 



ENTRY 



ACTION 



from the relocatable library. 
INCLUDE statements with blank 
operands are recognized only on 
SYSRDR. Each series of reloca- 
table modules on SYSIPT must be 
terminated by a /* control 
statement. 

To signal the end of the last 
input object module and to 
provide an optional transfer 
address for the first phase. 

To produce a main-storage map 
on SYSLST. 



The first (or only) object module input 
for the Linkage Editor must include a PHASE 
control statement before the first ESD 
item. The last (or only) object module may 
optionally be followed by an ENTRY control 
statement. The rules governing placement 
of INCLUDE and other PHASE control state- 
ments are discussed under Control Statement 
Placement. 



3. Assemble-and-Execute . Source modules 
can be assembled or compiled and then 
executed in a single sequence of job 
steps. In order to do this, the lan- 
guage translator is directed to output 
the object module directly on SYSOOO. 
This is done by using the LINK option 
in the OPTION control statement. Upon 
completion of this output operation, 
the Linkage Editor function is per- 
formed. The linkage- edited program is 
stored on SYSOOO. The sequence of 
events when this operation is performed 
is shown in the third diagram in Figure 
11. 



LI NKAGE EDITOR CONTROL STATEMENTS 



In addition to the program cards previously 
listed, object modules used as input for 
the Linkage Editor include Linkage Editor 
control statements. There are four kinds 
of these control statements. 

PHASE To indicate the beginning of a 
phase. It gives the name of 
the phase and the main-storage 
address where it is to be load- 
ed. 



SOURCES OF INPUT 



Input for the Linkage Editor is always from 
the tape unit assigned to SYSOOO. Object 
module input to SYSOOO can be: 

1. Output from the language translator 
programs immediately after a compila- 
tion or assembly. 

2. From only the card reader or tape unit 
assigned to SYSIPT. 

3. From SYSIPT and from the relocatable 
library. 

4. From only the relocatable library. 

In the first case, the LINK option in 
the OPTION control statement indicates to 
Job Control and to language translators 
that the output resulting from an assembly 
or compilation will be written directly on 
SYSOOO. 

In the second case, an INCLUDE statement 
with a blank operand indicates to Job Con- 
trol that the object module on SYSIPT is to 
be written on SYSOOO. 



INCLUDE To signal that an object module 
is to be included, A blank 
operand indicates to Job Con- 
trol that the module is on 
SYSIPT. An entry in the oper- 
and indicates that a module by 
that name is to be included 



In the third case, an INCLUDE statement 
with a blank operand indicates the presence 
of an object module on SYSIPT. An INCLUDE 
statement with an entry in the operand 
indicates that a module in the relocatable 
library is to be included in the program 
phase- 
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In the fourth case, an INCLUDE statement 
with an entry in the operand indicates that 
a module in the relocatable library is to 
be included in the program phase. Modules 
in the relocatable library can also contain 
INCLUDE statements. 



GENERAL CONTROL STATEMENT FORMAT 



The Linkage Editor control statements are 
similar in format to statements processed 
by the Assembler. The operation field must 
be preceded by one or more blanks. The 
operation field must begin to the right of 
column 1 and must be separated from the 
operand field by at least one blank posi- 
tion. The operand field is terminated by 
the first blank position. It cannot extend 
past column 71. 



CONTROL STATEMENT PLACEMENT 



When preparing multiple-object modules in a 
single Linkage Editor run, the single ENTRY 
statement should follow the last object 
module on SYSIPT. The ACTION statement 
immediately precedes the first PHASE state- 
ment . 

Figure 12 shows the possible placement 
of the PHASE and INCLUDE statements. 



INCLUDE STATEMENT 
(SYSRDR) 


PHASE STATEMENT 
(SYSRDR) 


"^ 


before first ESD 


after first PHASE ^ 




statement 


ESD 




TXT 




RLD 




REP 




END 




before next PHASE statement — -^- 


after END and before 
ENTRY or next ESD 


after last PHASE statement — ^ 


ENTRY (or next ESD) 





Note: INCLUDE statements within modules in the relocatable 
library must precede the ESD statement for the module. 

Figure 12. Placement of PHASE and INCLUDE 
Statements 



PHASE STATEMENT 



The PHASE statement must precede the first 
object module or INCLUDE statement of each 
phase processed by the Linkage Editor. 
Under no circumstances can a PHASE state- 
ment occur within a control section. This 
is an error condition that can result in 
erroneous program loading. There can be 
several control sections within a phase. 

This statement provides the Linkage 
Editor with a phase name and an origin 
point for the phase. The phase name is 
used to catalog the phase in the core image 
library. This name is used in a FETCH or 
LOAD macro to retrieve the phase for execu- 
tion. The PHASE statement is in the fol- 
lowing format. 

r T T 

|Oper-| I 

I ation I Operand | 

y + -^ 

|PHASE| name, origin I, (namelist) ] [,N0AUT03 | 

L ± . J 

The name field is blank. The operation 
field contains PHASE. Entries in the oper- 
and field must be separated by commas. The 
entries in the operand field represent the 
following. 



name 



origin 



Symbolic name of the phase. One 
to eight alphameric characters, 
the first of which must be 
alphabetic, are used as the 
phase name. If more than eight 
characters are used, those in 
excess of eight are truncated. 
Multi- phase programs must have 
phase names of five to eight 
alphameric characters, the first 
of which must be alphabetic. 
The first four characters of 
each phase within a multi-phase 
program must be the same. Oth- 
erwise, bytes 40-43 of the com- 
munication region will not con- 
tain an accurate indication of 
the uppermost byte used when 
loading problem program phases. 

Specifies the load address of 
the phase. The load address can 
be in one of three forms: 

1 . symbol I (phase) 3 [ irelocation] 

2. ♦ [irelocation] 

3 . ROOT 

4. +displacement 

The elements that make up the 
three forms that specify the 
origin signify the following. 

1* symbol ; may be a previously 
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defined phase name, a pre- 
viously defined control 
section, or a previously 
defined external label (the 
operand of an entry 
statement) . 

( phase ) : if symbol is a 
previously defined control 
section or a previously 
defined external label that 
appears in more than one 
phase, phase, (in 
parentheses) directs the 
Linkage Editor to the phase 
in which the origin name is 
to be found. The phase name 
must have been defined pre- 
viously. 

relocation ; indicates the 
origin of the phase cur- 
rently being processed will 
be set relative to the sym- 
bol by a relocation term 
consisting of a + or ei - 
immediately followed by a 
hexadecimal number X'hhhhhh' 
of one to six digits, or a 
decimal number dddddddd of 
one to eight digits. 

2 . ♦ : indicates the Linkage 
Editor phase location coun- 
ter. It will cause the 
Linkage Editor to assign the 
next main- storage location 
(with forced double-word 
alignment) as an origin for 
the next phase. 

relocation ; indicates relo- 
cation of the phase as des- 
cribeid above. 

3. ROOT: causes the Linkage 
Editor to consider the phase 
that follows as a root phase 
that will always be resident 
in main storage while the 
program is being executed . 
This phase will not be over- 
layed by any subsequent 
phase. The main-storage 
address assigned to this 
phase is the first double- 
word address after the area 
assigned to the COMMON pool 
(if any) and the label block 
area (if any) . Only the 
first PHASE statement is 
permitted to specify ROOT. 
If a control section appears 
in the root phase, other 
occurrences of the same 
control section are ignored 
and all references are 
resolved to the control 



section in the root. Con- 
trol sections are not dupli- 
cated within the same phase. 

4. + dis placement : allows the 
origin point (loading 
address) to be set at a 
specified location. The 
origin point is an absolute 
address, relative to zero. 
displacement is a hexadeci- 
mal number X'hhhhhh* of one 
to six digits, or a decimal 
number dddddddd of one to 
eight digits. 

(namelist) Causes the Linkage Editor to 

construct a phase from only the 
control sections specified. The 
namelist is in the following 
format . 

(csnamel, csname2, . . . ) 

Entries within the parentheses 
are the names of the control 
sections that will be used to 
constitute a phase. When the 
namelist option is used and only 
selected control sections are 
included in a phase, a sub- 
modular phase is created. The 
counterpart of a sub-modular 
phase is a normal phase. A 
normal phase contains all 
control sections of one or more 
object modules. A program 
should be composed either com- 
pletely of sub-modular phases or 
completely of normal phases. 
The total number of control 
sections referenced by a PHASE 
statement cannot exceed ten. 
Sub-modular phases cannot be 
constructed from any object 
module in the relocatable 
library. When several PHASE 
statements appear before an 
object module, each of the 
statements must contain the 
namelist option. Any object 
module not preceded by a PHASE 
statement will be included in 
the current phase. 

NOAUTO Indicates that the Automatic 
Library Look-Up (AUTOLINK) is 
suppressed. The AUTOLINK fea- 
ture provides the following. 
AUTOLINK collects each unre- 
solved external reference from 
the phase. It then searches the 
relocatable library for an 
object module with the same name 
as each unresolved external 
reference. When a match is 
found, the module in the reloca- 
table library is edited into the 
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phase. Object-module cross 
references with labels identical 
to library object -module entry- 
point labels are erroneous. The 
use of NOAUTO as the last 
operand in a PHASE statement 
causes the AUTOLINK process to 
be suppressed for that phase 
only. 

Some examples of PHASE statements follow. 

PHASE PHNAME,*+50U 

This causes loading to start 504 bytes past 
the end of the previous phase. 

PHASE PHNAME3,PHNAME2 

This causes loading to start in the same 
point where the loading of the phase by the 
name PHNAME2 started. 

PHASE PHNAME ROOT 

This causes loading to start after the 
label block area and the COMMON pool in the 
problem program area. This phase will 
never be overlayed by any other phase. 
When the PHASE statement contains a ROOT 
origin, this PHASE statement must be the 
first PHASE statement read by the Linkage 
Editor. 

PHASE PHNAME, CSECT1(PHNAME2) 

This causes loading to start at the point 
where CSECTl was loaded. CSECTl, the named 
control section, must have appeared in the 
phase named PHNAME 2. 

PHASE PHNAMEl,*, (CSECTl, CSECT3) 
PHASE PHNAME2,*, (CSECT2,CSECT4) 
PHASE PHNAME3 , PHNAME2 , (CSECT5, CSECT6) 

This sequence of PHASE statements causes 
the Linkage Editor to structure the next 
module composed of CSECT1-CSECT6 in three 
overlays as shown below. 



PHNAMEl 



PHNAME2 



CSECTl 



CSECT3 



CSECT2 



CSECT4 



PHNAME 3 



CSECT5 



CSECT6 



Because more than one PHASE statement 
appeared before the object module, each of 
the PHASE statements had to contain a con- 
trol section namelist. 

Note ; In each of the preceding examples, 
if the origin address supplied is not a 



double-word boundary, the Linkage Editor 
will automatically increment to the next 
double-word boundary. 

The Linkage Editor will allow the inclu- 
sion of the same control section within 
each of several phases except the root 
phase (if any) . In this case, as external 
references occur in a phase, they are 
resolved preferentially with the first 
previous corresponding entrypoint within 
the phase. If this is not possible, they 
are resolved with the first corresponding 
entrypoint anywhere within the program, if 
such an entrypoint exits. 



INCLUDE STATEMENT 



This statement is used to indicate that an 
object module is to be included for editing 
by the Linkage Editor. The statement has a 
single, optional operand. When the operand 
is omitted, the object module to be includ- 
ed is assumed to be next on SYSIPT. If an 
operand is present, the object module is 
assumed to be in the relocatable library. 
It must be the same module name that was 
used when the module was cataloged in the 
relocatable library. Including modules 
from the relocatable library permits the 
programmer to include standard subroutines 
in his program at linkage- edit time. 

The placement of the INCLUDE statement 
determines the position of the module in 
the program phase. An included module (in 
the relocatable library) can be preceded by 
one or more additional INCLUDE statements. 

The format of the INCLUDE statement is: 

r T T 1 

I Name | Operation | Operand | 
j. 1 ^ _ ^ 

I blank | INCLUDE | [modulename] | 

L . J J. J 

modulename Symbolic name of the module, 
as used when cataloged in the 
relocatable library. It con- 
sists of one alphabetic char- 
acter, followed by up to seven 
alphameric characters. 

Modules in the relocatable library can 
be nested by using INCLUDE statements up to 
a level of five. Modules included by 
INCLUDE statements read from SYSRDR are 
referred to as being in the first level . 
Modules included by statements in the first 
level are at the second level . This is 
illustrated in Figure 13. Modules included 
by statements in the second level are at 
the third level, and so on up to five 
levels . 



H2 



ENTRY STATEMENT 



Every program, as input for the Linkage 
Editor, is terminated by an ENTRY state- 
ment. Its format is: 

r T r ■ 1 

I Name | Operation | Operand | 
|. + + ^ 

I blank j ENTRY j [entrypoint] j 

L J, Jl J 

entrypoint Symbolic name of an entry 

point. It must be the name of 
a CSECT, a label definition, 
or a label reference, if the 
operand field is blank, the 
Linkage Editor will use as a 
transfer address the first 
significant address provided 
in an END record encountered 
during the generation of the 
first phase. If no such oper- 
and is found, the transfer 
address will be the load 
address of the phase. 



ACTION STATEMENT 



This statement is used to indicate that 
SYSLST is available for output. When used, 
the statement must precede the first PHASE 
statement. Its format is: 

r T ■ T 1 

I Name | Operation | Operand | 
j. + + ^ 

I blank I ACTION | MAP | 
L X -J. J 



MAP 



Indicates that SYSLST is avai- 
lable for diagnostic messages. 
In addition, a main storage 
map is output on SYSLST. The 
map contains every entry with- 
in each CSECT and every CSECT 
within each phase. 



Card 
Columns 



2-U 
5-6 
7-12 



13 



14-16 



17-72 



73-80 



Multiple punch (12-2-9). Iden- 
tifies this as a loader card. 

REP. Replace text card. 

Blank. 

Assembled address of the first 
byte to be replaced 
(hexadecimal) . 

Blank. 

External symbol identification 
number (ESID) of the control 
section (SD) containing the 
text. 

From 1 to 11 four- digit hexa- 
decimal fields separated by 
commas , each replacing one pre- 
viously loaded half word. A 
blank indicates the end of 
information in this card. 

May be used for program iden- 
tification. 



The REP card must be placed within the 
module that it modifies. If the module 
consists of input for more than one phase, 
REP must be placed within the bounds of the 
phase and after the text which it modifies. 
The Linkage Editor output as a result of 
the REP card is a newly created TXT card. 
This TXT card provides the necessary infor- 
mation and data to make the modification 
that was requested. (Address constants 
cannot be modified by REP cards since the 
RLD relocation applies only to TXT cards in 
the Linkage Editor input stream. ) 

Duplicate TXT card input containing 
address constants will not be relocated 
correctly. A REP or TXT card that causes 
loading of information outside the limits 
of a phase is^ processed. If the ACTION MAP 
control statement is used, a warning indi- 
cation of the condition is made. 



REP CARD 



PHASE ENTRY POINT 



The REP card allows substitution (or 
replacement) of new text for portions of 
assembled text. Each REP card contains the 
assembled address of the first byte to be 
replaced, and may contain from 2 to 22 
bytes of text. The text is substituted, 
byte for byte, for the original text, 
beginning at the address specified. Both 
the new address and the new text must be 
stated in hexadecimal, using the following 
format. 



The Linkage Editor stores with each phase 
the absolute entry point of that phase. 
These entry points are as follows. 

1. For the first phase, the entry point 
specified in the ENTRY statement is 
used. If no entry point is specified, 
the first significant entry address 
taken from an END statement encountered 
in the construction of the first phase 
is used. 
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2. For sub-modular phases, the entry point 
specified in the END statement of the 
module for the first phase constructed 
from the module is used. If subsequent 
phases are constructed from the module, 
the beginning address of each phase is 
used. 

3. For all other phases, the entry address 
specified in the first END statement 
encountered in the construction of the 
phase is used. 



SEQUENCE OF PHASES INPUT TO THE LINKAGE 
EDITOR 



The input sequence of phases, by phase 
name, is important only if the phases are 
to be cataloged in the core image library. 
Phases to be cataloged must be submitted in 
ascending order by phase name. If the 
program has a root phase, it must be the 
first and, therefore, must have the 
"lowest" phase name. The following 
sequence of PHASE statements is acceptable: 



The following are examples of incorrect 
phase sequences. 

PHASE ABCDl,* 
PHASE ABCD,ROOT 
PHASE ABCD2,* 
PHASE ABCD3,ABCD2 
PHASE ABCD4, ABCDl 

The preceding sequence is invalid 
because the PHASE statement containing ROOT 
must be the first PHASE statement in the 
sequence. 

PHASE ABCD,ROOT 
PHASE ABCDl,* 
PHASE ABCD2,* 
PHASE ABCD4, ABCDl 
PHASE ABCD3,ABCD2 

The preceding sequence is invalid 
because the phases by the names ABCD3 and 
ABCDU are not in ascending order. 



EXAMPLE OF LINKAGE EDITOR INPUT AND OUTPUT 



PHASE ABCD,ROOT 
PHASE ABCDl,* 
PHASE ABCD2,* 
PHASE ABCD3,ABCD2 
PHASE ABCDU, ABCDl 

This sequence of PHASE statements causes 
the Linkage Editor to structure the program 
as shown below. 



The program shown in Figure 13 illustrates 
the rules governing input for the Linkage 
Editor and shows the output obtained. 
Though this example is somewhat more com- 
plex than the normal program, by following 
the flow of the input one can find practi- 
cally every situation that may arise. 







} ABCD 




) ABCDl 




) ABCD3 




} ABCD2 



) ABCD4 
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SYSRDR 



PHASE PHASE! 



INCLUDE MOD2 



PHASE PHASE2 



INCLUDE 



EXEC ASSEMBLY 



ENTRY label CS A 



EXEC LNKEDT 




-Input- 



Relocatable Library 

Level 1 _^ 

© 



INCLUDE MODS 



INCLUDE MOD4 



ESD module 2 



TXT CS D 



RLD module 2 



END module 2 



ESD module 5 



TXT CS G 



RLD module 5 



END module 5 




Jiy 

Level 2 


ESD module 3 


TXT CS A 


TXT CS B 


RLD module 3 


END module 3 




ESD module 4 


TXT CS C 


RLD module 4 


END module 4 



SYSOOO (before editing) 



PHASE PHASE! 
INCLUDE MOD2 
PHASE PHASE2 
ESD module 1 
TXT CS E 
TXT CS F 
TXT CS E (cont) 
RLD module 1 
END module 1 
INCLUDE MODS 
ESD Assembler 
TXT CS H 
RLD Assembler 
END Assembler 
ENTRY label CS A 



SYSOOO (after editing) 



PHASE 1 



CS A 


CS B 


CSC 


CS D 


PHASE2 


CS E 


CS E (cont) 


CS F 


CS G 


CSH 



Figure 13. Example of Linkage Editor Input and Output 



The leftmost block shows control state- 
ments being read from SYSRDR. The next 
block is read from SYSIPT and contains an 
object module (module 1) and a source 
module to be assembled. The next two 
blocks represent two levels in the reloca- 
table library. The rightmost block shows 
the output phases as they appear on SYSOOO, 
both before and after the execution of the 
Linkage Editor function. 

1- The first INCLUDE statement accesses 
the relocatable library. Therefore, 
the first entry in module 2 must be 
either on ESD or another INCLUDE. In 
this case, module 2 begins with an 
INCLUDE statement. 



3. INCLUDE statements can be grouped. 



4. This split control section (CS E) is 
assigned a contiguous area of main 
storage. 



A source module can be assembled and 
combined with object modules from 
SYSIPT and the relocatable library 
during the same job step. It is 
assumed that the LINK option in the 
OPTION statement has been specified 
before this job step. The LINK option 
directs the language translator to 
output the object program on SYSOOO. 



2. 



In this case, module 3 begins with an 
ESD. 
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LIBRARIAN 



This section describes the set of programs 
that maintain and service the libraries of 
a 16K tape-resident system. This set of 
programs is collectively referred to as the 
Librarian. 

The system residence can contain three 
separate and distinct libraries: 

1. Core image library 

2. Source statement library 

3. Relocatable library. 

The core image library is required for 
each tape-resident system. The other two 
libraries, the source statement library and 
the relocatable library, are not required 
for operating a system. 



The purpose of the source statement 
library is to provide an extension of the 
functions of a macro library. If a source 
program contains a macro instruction, the 
macro definition in the source statement 
library corresponding to the macro instruc- 
tion is generated in the source program. 
If the source program contains a COPY 
statement, the specific language translator 
will compile a book from the source state- 
ment library into the source program. 

Each book in the source statement 
library is classified as belonging to a 
specific sub-library. Sub-libraries are 
currently defined for two programming lan- 
guages. Assembler and COBOL, in the system. 
Classifying books by a sub-library name 
allows books written in these languages to 
have the same name. 



CORE IMAGE LIBRARY 



The core image library contains any number 
of programs. Each program is made up of 
one or more separate phases. Hence, each 
phase may either be a single program, or an 
overlay in the case of a multiphase pro- 
gram. 

All programs in the core image library 
are edited to run with the resident Super- 
visor. Each program phase is assigned a 
fixed location in main storage. The pro- 
grams in the core image library include 
system programs, the librarian programs, 
other IBM programs such as Assembler, RPG, 
COBOL, FORTRAN, PL/I, and sort programs, 
and user programs. All programs in the 
library are in alphameric order. 

Associated with each phase in the core 
image library is a header describing the 
phase. Included in the header are the 
phase name, the starting main-storage 
address, the ending main- storage address, 
the maximum main-storage address used by 
any phase of the program, the entry-point 
address, the number of bytes per block, the 
number of blocks, and the length of the 
last block. 



Card images are stored in compressed 
form within the library. In the compressed 
format, all blanks are eliminated. When a 
book is retrieved, the card images are 
expanded to their original 80-character 
format. 

Associated with the source statement 
library are a source statement directory 
and a header record for each book in the 
library. The directory has entries defin- 
ing each sub-library and the books asso- 
ciated with each sub-library. Included in 
each header record are the identification 
of the source statement library, the number 
of records from the last tape mark, the 
sub- library name, the book name, and the 
number of records in the book. 

Books in a sub-library of the source 
statement library and entries in the source 
statement directory are in alphameric 
order. 

It is possible for the source statement 
library to reside on a separate tape. When 
this is desired, the symbolic name used to 
define the source statement library 
(SYSSLB) is assigned to a device other than 
the device assigned to the system residence 
symbolic name (SYSRES) . 



SOURCE STATEMENT LIBRARY 



RELOCATABLE LIBRARY 



The source statement library contains any 
number of books. Each book in the source 
statement library is made up of a sequence 
of source language statements in 80-80 
format. 



The relocatable library contains any number 
of modules. Each module is a complete 
object deck in the relocatable format. 
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The purpose of the relocatable library 
is to allow the user to maintain frequently 
used routines in residence and combine them 
with other modules without requiring recom- 
pilation. The routines from the relocata- 
ble library are edited on SYSOOO by the 
Linkage Editor. 

Associated with each module in the relo- 
catable library is a header describing the 
module. Included in the header are the 
identification of the relocatable library, 
the number of records from the last tape 
mark, the module name, and the number of 
records in the module. 

Modules in the relocatable library are 
in alphameric order. 

It is possible for the relocatable 
library to reside on a separate tape. When 
this is desired, the symbolic name used to 
define the relocatable library (SYSRLB) is 
assigned to a device other than the device 
assigned to the system residence symbolic 
name (SYSRES) . 



SSERV program is the service program for 
the source statement library. The RSERV 
program is the service program for the 
relocatable library. The DSERV program is 
the service program for the directories. 

Librarian functions are performed 
through use of control statements. The 
control statements are: 

1. A JOB control statement. 

2. A number of ASSGN control statements 
that may be required to change the 
assignment of actual input/output devi- 
ces. 

3. An EXEC control statement requesting a 
particular librarian program. 

4. Librarian specification statements 
describing various functions to be 
performed. 

5. A /* control statement. 

6. A /6 control statement. 



LIBRARIAN FUNCTIONS 



The Librarian programs perform two major 
functions: 



1. 
2. 



Maintenance 
Service. 



Maintenance functions are used to add, 
delete, or copy components of the three 
libraries. The MAINT program is the main- 
tenance program for all libraries defined 
for the system. 

Service functions are used to translate 
information from a particular library to 
printed (displayed) or punched output. 
Information in a library directory and 
header records can also be displayed. The 



The JOB, ASSGN, /*, and /6 control state- 
ments are the same as those described in 
the Job Control section. The operand field 
of the EXEC control statement is described 
in this section. The other statements 
pertain to the Librarian and are described 
in this section. 

Librarian functions can be performed 
separately, or in certain combinations as 
described in the following sections. All 
control statement information is read from 
the device assigned (in the ASSGN 
statements) to SYSRDR. All input data is 
read from the device assigned to SYSOOO or 
SYSIPT. SYSIPT and SYSRDR can be assigned 
to the same physical input/output device. 

Figure 14 is a table of all maintenance 
functions. Figure 15 is a table of all 
service functions. 
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Function 


Unit 


Element 


Control Statements Required 


Catalog 


Core Image 
Library 


Program 


// JOB jobname 
// OPTION CATAL 
// EXEC LNKEDT 

/& 


Source State- 
ment Library 


Book 


// JOB jobname 
// EXEC MAI NT 

CATALS sublib.bookname 
/* 
/& 


Relocatable 
Library 


Module 


// JOB jobname 
// EXEC MAI NT 

CATALR modulename 
/* 
/& 




Delete 


Core Image 
Library 


Phase 


// JOB jobname 
// EXEC MAI NT 

DELETC phasel[,phase2, ...] 
/* 
/& 


Program 


// JOB jobname 
// EXEC MAI NT 

DELETC progI.ALL[,prog2.ALL,...] 

/* 
/& 


Source State- 
ment Library 


Book 


// JOB jobname 
// EXEC MAI NT 

DELETS sublib.bookU,book2,...] 
/* 
/& 


Library 


// JOB jobname 
// EXEC MAI NT 

DELETS sublib.ALL 
/* 
/& 


Relocatable 
Library 


Module 


// JOB jobname 
// EXEC MA INT 

DELETR module! [,module2,...] 

/& 


Library 


// JOB jobname 
// EXEC MAI NT 

DELETR ALL 
/* 
/& 


Copy 


Core Image 
Library 


Library 


// JOB jobname 

// EXEC MAI NT 

COPY CL 

/* 
/& 


Source State- 
ment Library 


Library 


// JOB jobname 
// EXEC MAI NT 

COPY SL 
/* 
/& 




Relocatable 
Library 


Library 


// JOB jobname 
// EXEC MA INT 

COPY RL 
/* 
/& 


Core Image 
Library and 
Source State- 
ment Library 


Libraries 


// JOB jobname 
// EXEC MAI NT 
COPY CL,SL 
/* 
/& 


Core Image 
Library and 
Relocatable 
Library 


Libraries 


// JOB jobname 

// EXEC MAI NT 

COPY CL,RL 

/* 
/& 


System 


Libraries 


// JOB jobname 
// EXEC MAI NT 

COPY CL,SL,RL 
/* 
/& 



Function 


Unit 


Element 


Control Statements Required 


Display- 


Core Image 
Library 


Directory 


// JOB jobname 
// EXEC DSERV 

DSPLY CD 
/* 

A 


Source State- 
ment Library 


Book 


// JOB jobname 
// EXEC SSERV 

DSPLY 5ublib.bookll,book2, ...] 
/* 
/& 


Library 


// JOB jobname 
// EXEC SSERV 

DSPLY sublib.ALL 
/* 
/& 


Directory 


// JOB jobname 
// EXEC DSERV 

DSPLY SS 
/* 
/& 


Relocatable 
Library 


Module 


// JOB jobname 
// EXEC RSERV 

DSPLY modulel[,module2,...j 

/& 


Library 


// JOB jobname 
// EXEC RSERV 
DSPLY ALL 
/* 
/& 


Directory 


// JOB jobname 
// EXEC DSERV 

DSPLY RD 
/* 
/& 


Directories 


All 


// JOB jobname 
// EXEC DSERV 

DSPLY ALL 
/* 
/& 


Punch 


Source State- 
ment Library 


Book 


// JOB jobname 
// EXEC SSERV 

PUNCH sublib.bookI[,book2, ...J[,COMPRSD] 

/& 


Library 


// JOB jobname 
// EXEC SSERV 

PUNCH sublib.ALL(,COMPRSD] 

/& 


Relocatable 
Library 


Module 


// JOB jobname 
// EXEC RSERV 

PUNCH modulel[,module2, ...] 


Library 


// JOB jobname 
// EXEC RSERV 
PUNCH ALL 
/* 
/& 


Display 
and Punch 


Source State- 
ment Library 


Book 


// JOB jobname 
// EXEC SSERV 

DSPCH sublib.book1[,book2...][,COMPRSD] 
/* 
/& 


Library 


// JOB jobname 
// EXEC SSERV 

DSPCH 5ublib.ALL[,COMPRSD] 

/& 


Relocatable 
Library 


Module 


// JOB jobname 
// EXEC RSERV 

DSPCH modulel[,module2,...l 

/& 


Library 


// JOB jobname 
// EXEC RSERV 
DSPCH ALL 
/* 
/& 



Figure lU. Maintenance Functions 



Figure 15. Service Functions 
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MAINTENANCE FUNCTIONS 



SERVICE FUNCTIONS 



The set of maintenance functions contains 
three subsets: 

1. Catalog 

2. Delete 

3. Copy. 

The catalog function adds a phase to the 
core image library, adds a book to the 
source statement library, or adds a module 
to the relocatable library. If control 
statements and books or modules to be 
cataloged are read from the same device, 
the control statements must precede the 
associated book or module. Phases, books, 
or modules to be cataloged must be in 
alphameric sequence. 

Programs to be cataloged in the core 
image library must first be edited by the 
Linkage Editor on SYSOOO. Input for the 
Linkage Editor can be from SYSIPT or from 
the relocatable library. See the section 
entitled Linkage Edito r for a description 
of Linkage Editor functions that are per- 
formed prior to the catalog function for 
the core image library. 

The delete function deletes a program, 
book, or module from a library. Programs, 
books, or modules to be deleted must be in 
alphameric sequence according to the parti- 
cular library. 

The copy function is used to copy the 
tape-resident system selectively or com- 
pletely. A complete copy can be used to 
obtain backup if the original system is 
inadvertently destroyed. A selective copy 
can be used for reducing a complete system 
to a system that is designed to perform a 
specific purpose. 



The set of service functions contains three 
subsets : 

1. Display 

2 . Punch 

3. Display and punch. 

The tape-resident system can display 
and/or punch books in the source statement 
library, and modules in the relocatable 
library. In addition, the core image 
library header records, the source state- 
ment directory and header records, and the 
relocatable library header records can be 
displayed. 



Whenever a requested service function 
provides punched-card output, the output is 
on the device assigned to SYSPCH. Whenever 
a requested service function provides 
printed output, the output is on the device 
assigned to SYSLST. 



GENERAL CONTROL STATEMENT FORMAT 



The librarian control statements are simi- 
lar in format to statements processed by 
the Assembler. The operation field must be 
preceded by one or more blanks. The opera- 
tion field must begin to the right of 
column 1 and must be separated from the 
operand field by at least one bl^nk posi- 
tion. The operand field is terminated by 
the first blank position. It cannot extend 
past column 71. Continuation statements 
are not recognized. 



Control and Service Programs (16K Tape) 



U9 



LIBRARIAN FUNCTIONS: CORE IMAGE LIBRARY 



This section describes the maintenance 
functions that relate to the core image 
library. 



MAINTENANCE FUNCTIONS 



Input for the catalog function is from 
the tape unit assigned to SYSOOO. This 
tape contains output from the Linkage Edi- 
tor. 

If a phase in the core iitage library is 
to be replaced by a new phase having the 
same name, only the catalog function need 
be used. The delete function is implied 
with each catalog function. 



To request a maintenance function, other 
than the catalog function, for the core 
image library, use the following EXEC con- 
trol statement. 

// EXEC MAINT 

One or more of two maintenance functions 
(delete or copy) can be requested within a 
single run. Any number of programs with- 
in the core image library can be acted upon 
in this run. Further, one or more of the 
maintenance functions (catalog, delete, or 
copy) for either of the other two libraries 
(source statement or relocatable) can be 
requested within this run; the same MAINT 
program maintains all three of the librar- 
ies. 



Any number of phases can be cataloged in 
the core image library within a single run. 

For the catalog function for the core 
image library, SYSRDR must be assigned to a 
card reader or a tape unit. SYSOOO must be 
assigned to a tape unit. SYS002, the 
device on which the newly updated system 
library is located, must be assigned to a 
tape unit. SYSLST must be assigned to a 
printer or a tape unit, and SYSLOG can be 
assigned to a printer- keyboard. 



Control statement input for the catalog 
function, read from the device assigned to 
SYSRDR, is as follows. 



1. The JOB control statement, followed by 



C atalog 



The catalog function adds a phase to the 
core image library, while the MAINT pro- 
gram is the librarian program that catalogs 
a phase to the core image library, the 
manner of calling the MAINT program differs 
for the core image library. The CATAL 
option in the OPTION control statement 
indicates that upon encountering either // 
EXEC MAINT or /g, all programs which have 
been processed by the Linkage Editor will 
be cataloged in the core image library. 



Each phase that is cataloged in the core 
image library derives its name from the 
PHASE control statement. 



2. The ASSGN control statements, if the 
current assignments are not those 
required. The ASSGN statements that 
can be used are SYSRDR, SYSOOO, SYS002, 
SYSLST, and SYSLOG. The ASSGN state- 
ments are followed by 

3. The OPTION control statement, with 
CATAL specified in the operand field, 
followed by 

4. The appropriate Linkage Editor control 
statements (PHASE, INCLUDE, and ENTRY), 
followed by 

5. The EXEC LNKEDT control statement, 
followed by 

6. The /£ control statement, which is the 
last control statement of the job. 
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Delete 



The delete function is used to remove 
specific phases or programs from the core 
image library. Any number of phases or 
programs can be deleted during a single 
run. 



4. The DELETC control statement (s) , fol- 
lowed by 



5. The /* control statement, followed by 

6. The /S control statement, \yhich is the 
last control statement of the job. 



The DELETC control statement in one of 
the following formats is used to delete 
programs or phases from the core image 
library. 



DELETC phasenamel [ ,phasename2, . ,. . ] 

DELETC progl.ALLE , prog 2. ALL, ... 1 

In the first format, the entry in the 
operation field is DELETC. phasename in 
the operand field represents the name(s) of 
the phase (s) to be deleted. The name of 
the phase can be of any length; however, a 
maximum of the first eight characters is 
used to locate and delete the phase. 
Entries in the operand field must be sepa- 
rated by commas, and must be in alphameric 
sequence by phase name. 

In the second format, prog refers to the 
first four characters of the program name. 
(All phases within a program have the same 
first four characters. Therefore, the 
first four characters of each program with- 
in the library should be unique.) The four 
characters are followed by a period and 
ALL. 

Any number of DELETC control statements 
can be used for the core image library 
within a single run. 

For the delete function, SYSRDR must be 
assigned to a card reader or a tape unit. 
SYS00 2, the device on which the newly 
updated system library is located, must be 
assigned to a tape unit. SYSLST must be 
assigned to a printer or a tape unit, and 
SYSLOG can be assigned to the printer- 
keyboard. 

Control statement input for the delete 
function, read from the device assigned to 
SYSRDR, is as follows. 

1. The JOB control statement, followed by 

2. The ASSGN control statement, if the 
current assignments are not those 
required. The ASSGN statements that 
can be used are SYSRDR, SYS002, SYSLST, 
and SYSLOG. The ASSGN statements are 
followed by 

3. The EXEC MAINT control statement, fol- 
lowed by 



Copy 



The copy function is used to copy the sys- 
tem residence either selectively or com- 
pletely. The tape unit on which the system 
is to be copied is assigned to SYS002. 

A complete copy consists of copying each 
library and directory on the resident tape. 
The selective copy consists of copying only 
particular libraries. 

The COPY control statement in one of the 
following formats is used for the copy 
function. 

COPY CL 

COPY CL,SL 

COPY CL,RL 

COPY CL,SL,RL 

The first format is used when only the 
core image library is to be copied. The 
entry in the operation field is COPY. The 
entry in the operand field is CL. 

The second format is used when the core 
image library and the source statement 
library are to be copied. The entry in the 
operation field is COPY. The entries in 
the the operand field, separated by a 
comma, are CL and SL, 

The third format is used when the core 
image library and the relocatable library 
are to be copied. The entry in the opera- 
tion field is COPY. The entries in the 
operand field, separated by a comma, are CL 
and RL. 

The fourth format is used when the 
entire system is to be copied. The entry 
in the operation field is COPY. The 
entries in the operand field, separated by 
commas, are CL, SL, and RL. 

For the copy function, SYSRDR must be 
assigned to a card reader or a tape unit. 
SYS002 must be assigned to a tape unit. 
SYSLST must be assigned to a printer or a 
tape unit, and SYSLOG can be assigned to a 
printer- keyboard. 
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Control statement input for the copy 
function, read from the device assigned to 
SYSRDRr is as follows. 

1. The JOB control statement, followed by 

2. The ASSGN control statements, if the 
current assignments are not those 
required. The ASSGN statements that 
can be used are SYSRDR, SYS002, SYSLST, 
and SYSLOG. The ASSGN statements are 
followed by 

3. The EXEC MAINT control statement, fol- 
lowed by 

4. The COPY control statement, followed by 

5. The /♦ control statement, followed by 

6. The /& control statement, which is the 
last control statement of the job. 



LIBRARIAN RJNCTIONS; SOURCE STATEMENT 
LIBRARY 



This section describes the maintenance and 
service functions that relate to the source 
statement library. 



MAINTENANCE FUNCTIONS 



To request a maintenance function for the 
source statement library, use the following 
EXEC control statement. 

// EXEC MAINT 

One or more of the three maintenance 
functions for the source statement library 
can be requested within a single run. Any 
number of books within the source statement 
library can be acted upon in this run. 
Further, one or more of the maintenance 
functions for either of the other two 
libraries (core image or relocatable) can 
be requested within this run; the same 
MAINT program maintains all three librar- 
ies. 



Catalog 



The catalog function adds a book to a sub- 
library of the source statement library. 
Card input for the catalog function is from 
the device assigned to SYSIPT. Books to be 
cataloged in the source statement library 
must be in alphameric order. Any number of 
books can be added within a single run. 



The CATALS control statement is required 
to add a book to a sub- library of the 
source statement library. It is read from 
the device assigned to SYSRDR and is in the 
following format. 

CATALS sublib.bookname 

The operation field contains CATALS. 
The qualifier sublib in the operand field 
represents the sub-library to which the 
book is to be cataloged and can be: 

A for the Assembler sub-library 

C for the COBOL sub- library. 

bookname in the operand field represents 
the name of the book to be cataloged. The 
name of the book can be of any length; 
however, a maximum of the first eight char- 
acters is used to cataloged the book. 

Books that are to be cataloged in a sub- 
library of the source statement library 
must be preceded and followed by special 
statements indicating the beginning and the 
end of a book. 

Macro definitions that are to be catal- 
oged in the Assembler sub- library are 
preceded by the MACRO statement and are 
followed by the MEND statement. MACRO is 
the standard macro definition header state- 
ment; MEND is the standard macro definition 
trailer statement. 

Books other than macro definitions that 
are to be cataloged in either the Assembler 
or COBOL sub- library of the source state- 
ment library are preceded and followed by a 
BKEND statement. A BKEND statement must 
precede each book, and a BKEND statement 
must follow each book. If desired, the 
BKEND statement may precede and follow a 
macro definition (in addition to the MACRO 
and MEND statements). This would be desir- 
able when the options provided in the BKEND 
statement are required. The statement is 
in the following format. 

BKEND [sub. book] t,SEQNCE] [, count] [,COMPRSD] 

The first column of the statement must be 
blank. The entry in the operation field is 
BKEND. All operand entries are optional. 
When used, the entries must be in the pres- 
cribed order. The first entry in the oper- 
and field, sub. book , is identical to the 
operand of the CATALS control statement. 
If the second operand, SEQNCE, is speci- 
fied, columns 76 to 80 of the card images 
making up the book are checked for ascend- 
ing sequence numbers. The count operand 
specifies the number of card images in the 
book. When used, the card input is count- 
ed, beginning with the preceding BKEND 
statement and including the following BKEND 
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statement. If an error is detected in 
either the sequence checking or the card 
count, an error message is printed. The 
error can be corrected, and the book can be 
recataloged. The COMPRSD operand indicates 
that the book to be cataloged in the 
library is in the compressed format. 



It is possible to have the source state- 
ment library on a tape that does not con- 
tain the core image library, when this is 
true, the source statement library on the 
private tape is referenced by the symbolic 
name SYSSLB- The private library is built 
in one of two ways. First, a COPY function 
can be performed, copying the source state- 
ment library on the private tape. The 
alternate method is to define a completely 
new private tape. When this is the case, a 
special control statement is required that 
defines a new volume (NEWVOL) that contains 
the sub-libraries of the source statement 
library. This control statement is in the 
following format and precedes the first 
book to be cataloged to the first sub- 
library. 

NEWVOL 

The operation field contains NEWVOL. The 
operand field is blank. 

For the catalog function, SYSRDR must be 
assigned to a card reader or a tape unit. 
SYSIPT must be assigned to a card reader or 
a tape unit, SYSSLB must be assigned to a 
tape unit, if the source statement library 
is on a private tape. SYSOOO and SYSOOl 
are used as work files and must each be 
assigned to a tape unit. SYS002, the 
device on which the newly updated library 
is located, must be assigned to a tape 
unit. SYSLST must be assigned to a printer 
or a tape unit, and SYSLOG can be assigned 
to a printer- keyboard. 

Control statement input, read from the 
device assigned to SYSRDR, is as follows. 

1. The JOB control statement, followed by 

2. The ASSGN control statements, if the 
current assignments are not those 
required. The ASSGN statements that 
can be used are SYSRDR, SYSIPT, SYSSLB, 
SYSOOO, SYSOOl, SYS002, SYSLST, and 
SYSLOG. The ASSGN Statements are fol- 
lowed by 

3. The EXEC MAINT control statement, fol- 
lowed by 

4. The NEWVOL control statement, if a new 
library is being defined, followed by 

5. The CATALS control statement ( s) , fol- 
lowed by 



6. The /♦ control statement, followed by 

7. The /S control statement, which is the 
last control statement of the job. 

Card image input, read from the device 
assigned to SYSIPT, is as follows. 

1. The BKEND statement, and/or the MACRO 
header statement if the book is a macro 
definition, followed by 

2. The book to be cataloged, followed by 

3. The BKEND statement, and/or the MEND 
trailer statement if the book is a 
macro definition. 

If SYSRDR and SYSIPT are assigned to the 
same device, the books to be cataloged 
immediately follow their respective CATALS 
control statements. 



Delete 



The delete function is used to remove 
specific books from a sub- library of the 
source statement library. The function can 
also be used to delete an entire sub- 
library. Any number of books from a 
specific sub-library can be deleted during 
a single run. 

The DELETS control statement in one of 
the following formats is used to delete 
books from the source statement library. 

DELETS sublib. bookl [ , book2', . . . ] 

DELETS sublib. ALL 

The first format is used if only speci- 
fic books are to be deleted from a specific 
sub-library. The entry in the operation 
field is DELETS. The qualifier sublib in 
the operand field represents the sub- 
library containing the book to be deleted 
and can be: 

A for the Assembler sub- library 

C for the COBOL sub- library. 

book in the operand field represents the 
name of the book in the sub- library to be 
deleted. If more than one book from a 
specific sub-library is to be deleted, sub- 
sequent book names need not be qualified. 
Books to be deleted must be in alphameric 
sequence. Entries in the operand field 
must be separated by commas . The name of 
the book can be of any length; however, a 
maximum of the first eight characters is 
used to locate and delete the book. 
Continuation statements are not recognized. 
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The second format is used if an entire 
sub- library is to be deleted. The entry in 
the operation field is DELETS. The first 
entry in the operand field is the name of 
the sub-library to be deleted. sublib 
represents the sub-library to be deleted 
and can be: 

A for the Assembler sub- library 

C for the COBOL sub- library. 

The second entry in the operand field is 
ALL. The two entries must be separated by 
a period. 

For the delete function, SYSRDR must be 
assigned to a card reader or a tape unit. 
SYSSLB must be assigned to a tape unit, if 
the source statement library is on a pri- 
vate tape. SYSOOl is used as a work file 
and must be assigned to a tape unit. 
SYS00 2, the device on which the newly 
updated library is located, must be 
assigned to a tape unit. SYSLST must be 
assigned to a printer or a tape unit, and 
SYSLOG can be assigned to the printer- 
keyboard. 

Control statement input for the delete 
function, read from the device assigned to 
SYSRDR, is as follows. 

1. The JOB control statement, followed by 

2. The ASSGN control statements, if the 
current assignments are not those 
required. The ASSGN statements that 
can be used are SYSRDR, SYSSLB, SYSOOl, 
SYS002, SYSLST, and SYSLOG. The ASSGN 
statements are followed by 

3. The EXEC MAINT control statement, fol- 
lowed by 

4. The DELETS control statement (s) , fol- 
lowed by 

5. The /♦ control statement, followed by 

6. The /S control statement, which is the 
last control statement of the job. 



The entry in the operation field is 
COPY. The entry in the operand field is 
SL. 

For the copy function, SYSRDR must be 
assigned to a card reader or a tape unit. 
SYSSLB must be assigned to a tape unit, if 
the source statement library is on a pri- 
vate tape. SYS002 must be assigned to a 
tape unit. SYSLST must be assigned to a 
printer or a tape unit, and SYSLOG can be 
assigned to a printer- keyboard. 

Control statement input for the copy 
function, read from the device assigned to 
SYSRDR, is as follows. 

1. The JOB control statement, followed by 

2. The ASSGN control statements, if the 
current assignments are not those 
required. The ASSGN statements that 
can be used are SYSRDR, SYSSLB, SYS002, 
SYSLST, and SYSLOG. The ASSGN state- 
ments are followed by 

3. The EXEC MAINT control statement, fol- 
lowed by 

H, The COPY control statement, followed by 

5. The /* control statement, followed by 

6. The /6 control statement, which is the 
last control statement of the job. 



SERVICE FUNCTIONS 



To request a service function for the 
source statement library, use the following 
EXEC control statement . 

// EXEC SSERV 

One or more of the three service func- 
tions can be requested within a single run. 
Any number of books within the source 
statement library can be acted upon in this 
run. 



C opy 



Display 



The copy function is used to copy the 
source statement library on another tape. 
The tape unit on which the library is to be 
copied is assigned to SYS002. 

The COPY control statement in the fol- 
lowing format is used for the copy func- 
tion - 

COPY SL 



The display function is used to get a 
print- out of a book in the source statement 
library. Any number of books can be dis- 
played within a single run. The printed 
output consists of a header and the infor- 
mation contained within the book. 

Contained within the printed header is 
the name of the book and the number of 
records within the book. 



5^ 



Books are displayed in the card image 
format. Each book is preceded and followed 
by a BKEND statement. 

The DSPLY control statement in one of 
the following formats is used to display 
books in the source statement library. 

DSPLY sublib.booklE ,book2, . . .3 

DSPLY sublib.ALL 

The first format is used if only speci- 
fic books are to be displayed from a speci- 
fic sub-library. The entry in the opera- 
tion field is DSPLY. The qualifier sublib 
in the operand field represents the sub- 
library containing the book to be displayed 
and can be: 

A for the Assembler sub- library 

C for the COBOL sub- library. 

book in the operand field represents the 
name of the book in the sub- library to be 
displayed. If more than one book from a 
specific sub- library is to be displayed, 
subsequent book names need not be 
qualified. Books to be displayed must be 
in alphameric sequence. Entries in the 
operand field must be separated by commas. 
The name of the book can be of any length; 
however, a maximum of the first eight char- 
acters is used to locate and display the 
book. Continuation statements are not 
recognized. 

The second format is used if an entire 
sub-library is to be displayed. The entry 
in the operation field is DSPLY. The first 
entry in the operand field is the name of 
the sub-libraify to be displayed, subjib 
can be: 

A for the Assembler sub- library 

C for the COBOL sub- library. 

The second entry in the operand field is 
ALL. The two entries must be separated by 
a period. 

For the display function, SYSRDR must be 
assigned to a card reader or a tape unit. 
SYSSLB must be assigned to a tape unit, if 
the source statement library is on a pri- 
vate tape. SYSLST must be assigned to a 
printer or a tape unit. SYSLOG can be 
assigned to a printer-keyboard. 

Control statement input for the display 
function, read from the device assigned to 
SYSRDR, is as follows. 

1. The JOB control statement, followed by 

2. The ASSGN control statements, if the 



current assignments are not those 
required. The ASSGN statements that 
can be used are SYSRDR, SYSLST, SYSSLB, 
and SYSLOG. The ASSGN statements are 
followed by 

3. The EXEC SSERV control statement, fol- 
lowed by 

4. The DSPLY control statement (s) , fol- 
lowed by 

5. The /♦ control statement, followed by 

6. The /£ control statement, which is the 
last control statement of the job. 



Punch 



The punch function is used to convert a 
book in the source statement library into a 
punched-card output deck. The resulting 
punched-card deck consists of card images 
of the book in the library. If the option- 
al operand, C0MPR3D, is specified, the card 
images are punched in the compressed form 
in which they are stored in the library. 
Each book is preceded and followed by a 
BKEND card. 

Any number of books in the source state- 
ment library can be punched within a single 
run. 

The PUNCH control statement in one of 
the following formats is used to punch 
books in the source statement library. 

PUNCH sublib. bookl [ , book2 ,...][, COMPRSD] 

PUNCH sublib. ALL [, COMPRSD] 

The first format is used if only speci- 
fic books are to be punched from a specific 
sub-library. The entry in the operation 
field is PUNCH. The qualifier sublib in 
the operand field represents the sub- 
library containing the book to be punched 
and can be: 

A for the Assembler sub-library 

C for the COBOL sub- library. 

book in the operand field represents the 
name of the book in the sub-library to be 
punched. If more than one book from a 
specific sub-library is to be punched, sub- 
sequent book-names need not be qualified. 
The entry COMPRSD is used if the books are 
to be punched in the compressed form in 
which they are stored in the library. When 
this option is selected, the cards are 
punched in the first seventy-one columns. 
Books to be punched must be in alphameric 
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sequence. Entries in the operand field 
must be separated by commas. The name of 
the book can be of any length; however, a 
maximum of the first eight characters is 
used to locate and punch the book. 
Continuation statements are not recognized. 

The second format is used if an entire 
sub-library is to be punched. The entry in 
the operation field is PUNCH. The first 
entry in the operand field is the name of 
the sub-library to be punched, sublib can 
be: 

A for the Assembler sub- library 

C for the COBOL sub- library. 

The second entry in the operand field is 
ALL. The entry COMPRSD is used if the 
books are to be punched in the compressed 
format. 

For the punch function, SYSRDR must be 
assigned to a card reader or a tape unit. 
SYSSLB must be assigned to a tape unit, if 
the source statement library is on a pri- 
vate tape. SYSPCH must be assigned to a 
card punch or a tape unit. SYSLST must be 
assigned to a printer or a tape unit, and 
SYSLOG can be assigned to a printer- 
keyboard. 

Control statement input for the punch 
function, read from the device assigned to 
SYSRDR, is as follows. 

1. The JOB control statement, followed by 

2. The ASSGN control statements, if the 
current assignments are not those 
required. The ASSGN statements that 
can be used are SYSRDR, SYSSLB, SYSPCH, 
SYSLST, and SYSLOG. The ASSGN State- 
ments are followed by 

3. The EXEC SSERV control statement, fol- 
lowed by 

4. The PUNCH control statement (s) , fol- 
lowed by 

5. The /♦ control statement, followed by 

6. The /£ control statement, which is the 
last control statement of the job. 



Display and Punch 



The display-and-punch function is used to 
combine the separate operations of the 
display function and the punch function. 
The output of the display-and-punch func- 
tion is identical to that described in the 
two preceding subsections. Any number of 



books in a specific sub- library of the 
source statement library can be displayed 
and punched within a single run. 

The DSPCH control statement in one of 
the following formats is used to convert 
books in a sub- library of the source state- 
ment library to printed and punched- card 
output . 

DSPCH sublib. bookl [ , book2 ,...][, COMPRSD] 

DSPCH s Ublib. ALL [, COMPRSD] 

The first format is used if only speci- 
fic books are to be displayed and punched 
from a specific sub-library. The entry in 
the operation field is DSPCH. The qualifi- 
er sublib in the operand field represents 
the sub-library containing the book to be 
displayed and punched and can be: 

A for the Assembler sub- library 

C for the COBOL sub- library. 

book in the operand field represents the 
name of the book in the sub-library to be 
displayed and punched. If more than one 
book from a specific sub-library is to be 
displayed and punched, subsequent book- 
names need not be qualified. The entry 
COMPRSD is used if the books are to be 
punched in the compressed form in which 
they are stored in the library, but printed 
in the original card image format. Books 
to be displayed and punched must be in 
alphameric sequence. Entries in the oper- 
and field must be separated by commas. The 
name of the book can be of any length; 
however, a maximum of the first eight char- 
acters is used to locate and display and 
punch the book. Continuation statements 
are not recognized. 

The second format is used if an entire 
sub-library is to be displayed and punched. 
The entry in the operation field is DSPCH. 
The first entry in the operand field is the 
name of the sub- library to be displayed and 
punched, sublib can be: 

A for the Assembler sub-library 

C for the COBOL sub-library. 

The second entry in the operand field is 
ALL. The entry COMPRSD is used if the 
books are to be punched in the compressed 
format . 

For the display and punch function, 
SYSRDR must be assigned to a card reader or 
a tape unit. SYSSLB must be assigned to a 
tape unit, if the source statement library 
is on a private tape. SYSLST must be 
assigned to a printer or a tape unit. 
SYSPCH must be assigned to a card punch or 
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a tape unit. SYSLDG can be assigned to a 
printer- keyboard . 

Control statement input for the display 
and punch function, read from the device 
assigned to SYSRDR, is as follows. 

1. The JOB control statement, followed by 

2. The ASSGN statements, if the current 
assignments are not those required. 
The ASSGN statements that can be used 
are SYSRDR, SYSSLB, SYSLST, SYSPCH, and 
SYSLOG. The ASSGN Statements are fol- 
lowed by 

3. The EXEC SSERV control statement, fol- 
lowed by 

U. The DSPCH control statement (s) , fol- 
lowed by 

5. The /♦ control statement, followed by 

6. The /6 control statement, which is the 
last control statement of the job. 



LIBRARIAN FUNCTIONS; RELOCATABLE LIBRARY 



This section describes the maintenance and 
service functions that relate to the relo- 
catable library. 



library is the output of a complete 1 
guage translator run. 



an- 



MAINTENANCE FUNCTIONS 



A module added to the relocatable 
library is removed by using the delete 
function. 

The catalog function implies a delete 
function. Thus, if a module exists in the 
relocatable library with the same name as a 
module to be cataloged, the module in the 
relocatable library is deleted. 

The CATALR control statement is required 
to add a module to the relocatable library. 
The CATALR control statement is read from 
the device assigned to SYSRDR and is in the 
following format. 

CATALR modulename 

The operation field contains CATALR. 
The entry in the operand field, modulename , 
is the name by which the module will be 
known to the control system. The module- 
name is one to eight alphameric characters, 
the first of which must be alphabetic. 

The cards composing the input for a 
module are described in the section enti- 
tled Linkage Editor . The cards are: 

1. INCLUDE control statement (if 
appropriate) 

2. ESD card 

3. TXT card 
t\, REP card 

5. Rep card 

6. END card. 



To request a maintenance function for the 
relocatable library,, use the following EXEC 
control statement. 

// EXEC MAINT 

One or more of the three maintenance 
functions for the relocatable library can 
be requested within a single run. Any 
number of modules within the relocatable 
library can be acted upon in this run. 
Further, one or more of the maintenance 
functions for either of the other two 
libraries (core image or source statement) 
can be requested within this run, for the 
same MAINT program maintains all three 
libraries. 



Catalog 



The catalog function adds a module to the 
relocatable library. Input for the catalog 
function is from the device assigned to 
SYSIPT. A module in the relocatable 



These input cards are read from the device 
assigned to SYSIPT. 

It is possible to have the relocatable 
library on a tape that does not contain the 
core image library. When this is true, the 
relocatable library on the private tape is 
referenced by the symbolic name SYSRLB. 
The private library is built in one of two 
ways. First, a COPY function can be per- 
formed, copying the relocatable library on 
the private tape. The alternate method is 
to define a completely new private tape. 
When this is the case, a special control 
statement is required that defines a new 
volume (NEWVOL) that contains the relocata- 
ble library. This control statement is in 
the following format and precedes the first 
module to be cataloged to the newly defined 
relocatable library. 

NEWVOL 

The operation field contains NEWVOL. The 
operand field is blank. 

For the catalog f\inction, SYSRDR must be 
assigned to a card reader or a tape unit. 
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SYSIPT must be assigned to a card reader or 
a tape unit. SYSRLB must be assigned to a 
tape unit, if the relocatable library is on 
a private tape. SYSOOO and SYSOOl are used 
as work files and must each be assigned to 
a tape unit. SYS002, the device on which 
the newly updated library is located, must 
be assigned to a tape unit. SYSLST must be 
assigned to a printer or a tape unit, and 
SYSLOG can be assigned to a printer- 
keyboard. 

Control statement input, read from the 
device assigned to SYSRDR, is as follows. 

1. The JOB control statement, followed by 

2. The ASSGN control statements, if the 
current assignments are not those 
required. The ASSGN statements that 
can be used are SYSRDR, SYSIPT, SYSRLB, 
SYSOOO, SYSOOl, SYS002, SYSLST, and 
SYSLOG. The ASSGN Statements are fol- 
lowed by 

3. The EXEC MAINT control statement, fol- 
lowed by 

4. The NEWVOL control statement, if a new 
library is being defined, followed by 

5. The CATALR control statement (s) , fol- 
lowed by 

6. The /* control statement, followed by 

7. The /6 control statement, which is the 
last control statement of the job. 



Delete 



The delete function is used to remove 
specific modules from the relocatable 
library. The function can also be used to 
delete the entire relocatable library. Any 
number of modules can be deleted during a 
single run. 

The DELETR control statement in one of 
the following formats is used to delete 
modules from the relocatable library. 

DELETR modname [ , modname , . . . ] 

DELETR ALL 

The first format is used when a specific 
module is to be deleted. The entry in the 
operation field is DELETR. The entry in 
the operand field, modname, is the name of 
the module to be deleted. If more than one 
module is to be deleted, the module names 
are separated by a comma. Modules to be 
deleted must be in alphameric sequence. 
modname is one to eight alphameric charac- 



ters, the first of which must be alphabetic 
Continuation statements are not recognized. 

The second format is used if the entire 
library is to be deleted. The entry in the 
operation field is DELETR. The entry in 
the operand field is ALL. 

Any number of DELETR control statements 
can be used for the relocatable library 
within a single run. 

For the delete function, SYSRDR must be 
assigned to a card reader or a tape unit. 
SYSRLB must be assigned to a tape unit, if 
the relocatable library is on a private 
tape. SYSOOl is used as a work file and 
must be assigned to a tape unit. SYS002, 
the device on which the newly updated 
library is located, must be assigned to a 
tape unit. SYSLST must be assigned to a 
printer or a tape unit, and SYSLOG can be 
assigned to the printer-keyboard. 

control statement input for the delete 
function, read from the device assigned to 
SYSRDR, is as follows. 

1. The JOB control statement, followed by 

2. The ASSGN control statements, if the 
current assignments are not those 
required. The ASSGN statements that 
can be used are SYSRDR, SYSRLB, SYSOOl, 
SYS002, SYSLST, and SYSLOG. The ASSGN 
statements are followed by 

3. The EXEC MAINT control statement, fol- 
lowed by 

4. The DELETR control statement (s) , fol- 
lowed by 

5. The /♦ control statement, followed by 

6. The /£ control statement, which is the 
last control statement of the job. 



Copy 



The copy function is used to copy the relo- 
catable library on another tape. The tape 
unit on which the library is to be copied 
is assigned to SYS002. 

The COPY control statement in the fol- 
lowing format is used for the copy func- 
tion. 

COPY RL 

The entry in the operation field is 
COPY. The entry in the operand field is 
RL. 
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For the copy function, SYSRDR must be 
assigned to a card reader or a tape unit. 
SYSRLB must be assigned to a tape unit, if 
the relocatable library is on a private 
tape. SYS002 must be assigned to a tape 
unit. SYSLST must be assigned to a printer 
or a tape unit, and SYSLOG can be assigned 
to a printer- keyboard. 

Control statement input for the copy 
function, read from the device assigned to 
SYSRDR, is as follows. 

1. The JOB control statement, followed by 

2. The ASSGN control statements, if the 
current assignments are not those 
required. The ASSGN statements that 
can be used are SYSRDR, SYSRLB, SYS002, 
SYSLST, and SYSLOG. The ASSGN state- 
ments are followed by 

3. The EXEC MAINT control statement, fol- 
lowed by 

4. The COPY control statement, followed by 

5. The /♦ control statement, followed by 

6. The /S control statement, which is the 
last control statement of the job,. 



SERVICE FUNCTIONS 



The DSPLY control statement in one of 
the following formats is used to display 
modules in the relocatable library. 

DSPLY modulel [,module2, . . . ] 

DSPLY ALL 

The first format is used if only speci- 
fic modules are to be displayed. The entry 
in the operation field is DSPLY. The entry 
in the operand field, module , represents 
the name of the module to be displayed. If 
more than one module is to be displayed, 
the module names are separated by commas. 
Modules to be displayed must be in alpham- 
eric sequence. Module names are from one 
to eight characters long. Continuation 
statements are not recognized. 

The second format is used if the entire 
relocatable library is to be displayed. 
The entry in the operation field is DSPLY 
The entry in the operand field is ALL. 

For the display function, SYSrdR must be 
assigned to a card reader or a tape unit. 
SYSRLB must be assigned to a tape unit, if 
the relocatable library is on a private 
tape. SYSLST must be assigned to a printer 
or a tape unit. SYSLOG can be assigned to 
a printer- keyboard. 

Control statement input for the display 
function, read from the device assigned to 
SYSRDR, is as follows. 



To request a service function for the relo- 
catable library, use the following EXEC 
control Stat ement . 

// EXEC RSERV 

One or more of the three service func- 
tions can be requested within a single run. 
Any number of modules within the relocata- 
ble library can be acted upon in this run. 



Display 



The display function is used to get a 
print-out of a module in the relocatable 
library. Any number of modules can be 
displayed within a single run. The printed 
output consists of a header and the module. 

Contained in the printed header is the 
module name and the number of records need- 
ed to contain the module. 

The printed output of the module is 
represented by hexadecimal characters and 
EBCDIC, depending on the type of record and 
the information contained within the 
record. 



1. The JOB control statement, followed by 

2. The ASSGN control statements, if the 
current assignments are not those 
required. The ASSGN statements that 
can be used are SYSRDR, SYSRLB, SYSLST, 
and SYSLOG. The ASSGN Statements are 
followed by 

3. The EXEC RSERV control statement, fol- 
lowed by 

4. The DSPLY control statement (s) , fol- 
lowed by 

5. The /♦ control statement, followed by 

6. The /£ control statement, which is the 
last control statement of the job. 



Punch 



The punch function is used to convert a 
module in the relocatable library into a 
punched- card output deck. 

Any number of modules in the relocatable 
library can be punched within a single run. 
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The punched- card output is acceptable to 
every function that uses relocatable 
modules as input. 



The PUNCH control statement in one of 
the following formats is used to convert 
modules in the relocatable library to 
punched-card output. 



PUNCH modulel L,module2, . . . ] 



PUNCH ALL 



The first format is used if only speci- 
fic modules are to be punched. The entry 
in the operation field is PUNCH. The entry 
in the operand field, module , represents 
the name of the module to be punched. If 
more than one module is to be punched, the 
module names are separated by commas. 
Modules to be punched must be in alphameric 
sequence. Module names are from one to 
eight characters long. Continuation state- 
ments are not recognized. 



The second format is used if the entire 
relocatable library is to be punched. The 
entry in the operation field is PUNCH. The 
emtry in the operand field is ALL. 

For the punch function, SYSRDR must be 
assigned to a card reader or a tape unit. 
SYSRLB must be assigned to a tape unit, if 
the relocatable library is on a private 
tape. SYSPCH must be assigned to a card 
punch or a tape unit. SYSLST must be 
assigned to a printer or a tape unit, and 
SYSLOG can be assigned to a printer- key- 
board. 

Control statement input for the punch 
function, read from the device assigned to 
SYSRDR, is as follows. 

1. The JOB control statement, followed by 

2 . The ASSGN control statements , if the 
current assignments are not those 
required. The ASSGN statements that 
can be used are SYSRDR, SYSRLB, SYSPCH, 
SYSLST, and SYSLOG. The ASSGN state- 
ments are followed by 

3. The EXEC RSERV control statement, fol- 
lowed by 

4. The PUNCH control statement (s) , fol- 
lowed by 

5. The /♦ control statement, followed by 

6. The /£ control statement, which is the 
last control statement of the job. 



Display and Punch 



The display-and-punch function is used to 
combine the separate operations of the 
display function and the punch function. 
The output of the display-and-punch func- 
tion is identical to that described in the 
two preceding subsections . Any number of 
modules in the relocatable library may be 
displayed and punched within a single run. 



The DSPCH control statement is used to 
convert modules in the relocatable library 
to printed and punched-card output. The 
DSPCH control statement is in one of the 
following formats. 



DSPCH modulel [ ,module2, . . . ] 

DSPCH ALL 

The first format is used if only speci- 
fic modules are to be displayed and 
punched. The entry in the operation field 
is DSPCH. The entry in the operand field, 
module , represents the name of the module 
to be displayed and punched. If more than 
one module is to be displayed and punched, 
the module names are separated by commas. 
Modules to be displayed and punched must be 
in alphameric sequence. Module names are 
from one to eight characters long. Con- 
tinuation statements are not recognized. 

The second format is used if the entire 
relocatable library is to be displayed and 
punched. The entry in the operation field 
is DSPCH. The entry in the operand field 
is ALL. 

For the display-and-punch function, 
SYSRDR must be assigned to a card reader or 
a tape unit. SYSRLB must be assigned to a 
tape unit, if the relocatable library is on 
a private tape. SYSLST must be assigned to 
a printer or a tape unit. SYSPCH must be 
assigned to a card punch or a tape unit, 
SYSLOG can be assigned to a printer- 
keyboard. 

Control statement input for the display 
and punch function, read from the device 
assigned to SYSRDR, is as follows. 

1. The JOB control statement, followed by 

2. The ASSGN control statements, if the 
current assignments are not those 
required. The ASSGN statements that 
can be used are SYSRDR, SYSRLB, SYSLST, 
SYSPCH, and SYSLOG. The ASSGN state- 
ments are followed by 

3. The EXEC RSERV control statement, fol- 
lowed by 
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4. The DSPCH control statement (s) , fol- 
lowed by 

5. The /♦ control statement, followed by 

6. The /6 control statement, which is the 
last control statement of the job. 



LIBRARIAN FUNCTIONS: DIRECTORIES 



This section describes the service func- 
tion, display, that relates to the three 
directories. A directory on the tape resi- 
dent system is made up of the header 
records that precede each program, book, or 
module in the core image library, the 
source statement library, or the relocata- 
ble library, respectively. 

To request the display service function 
for a directory, use the following EXEC 
control statement. 

// EXEC DSERV 

Any number of directories can be displayed 
within a single run. 

Each printed line contains one header 
record. The phase, book, or module name is 
displayed in EBCDIC. All other fields are 
represented by hexadecimal characters. 

The DSPLY control statement in the fol- 
lowing format is used to display specific 
directories or all directories. 

DSPLY dirl[,dir2[,dir3]] 

DSPLY ALL 

The first format is used if only speci- 
fic directories are to be displayed. The 
entry in the operation field is DSPLY. The 
entry in the operand field, dir , represents 
the name of the directory to be displayed. 
It can be: 

CD for the core image directory 

SS for the source statement directory 

RD for the relocatable directory. 

If more than one directory is to be dis- 
played, the symbols for the directories 
must be separated by a comma and can be in 
any order. 

The second format is used if all three 
directories are to be displayed. The entry 
in the operation field is DSPLY. The entry 
in the operand field is ALL. 

For the display function, SYSRDR must be 
assigned to a card reader or a tape unit. 
SYSLST must be assigned to a printer or a 



tape unit. If the operand ALL or SS is 
used, and if the source statement library 
is on a private tape, SYSSLB must be 
assigned to a tape unit. If the operand 
ALL or RD is used, and if the relocatable 
library is on a private tape, SYSRLB must 
be assigned to a tape unit. SYSLOG can be 
assigned to a printer- keyboard. 

Control statement input for the display 
function, read from the device assigned to 
SYSRDR, is as follows. 

1. The JOB control statement, followed by 

2. The ASSGN control statements, if the 
current assignments are not those 
required. The ASSGN statements that 
can be used are SYSRDR, SYSLST, SYSSLB, 
SYSRLB, and SYSLOG. The ASSGN state- 
ments are followed by 

3. The EXEC DSERV control statement, fol- 
lowed by 

4. The DSPLY control statement, followed 
by 

5. The /* control statement, followed by 

6. The /6 control statement, which is the 
last control statement of the job. 



SYSTEM GENERATION 



This section describes the general proce- 
dure that are followed in generating a tape 
resident basic operating system. 

The tape resident system is received on 
a tape. The tape received contains three 
defined libraries: the core image, reloca- 
table, and source statement. The libraries 
contain the following components. 

1. Core image library . Contains programs 
in the core image format. The programs 
in the core image library are the 
Supervisor and its associated transient 
routines (OPEN, CLOSE, etc) , Job Con- 
trol, Linkage Editor, MAINT, and Assem- 
bler. All programs in the core image 
library are edited to run with the 
Supervisor supplied by IBM. 

2. Relocatable library . Contains modules 
in the relocatable format. The modules 
in the relocatable library are the 
resident control program and service 
programs. These programs include Job 
control. Linkage Editor, and the 
librarian programs. The librarian 
programs are MAINT, SSERV, RSERV, and 
DSERV. Other programs that can be in 
the relocatable library are Assembler, 



Control and Service Programs (16K Tape) 61 



COBOL, FORTRAN, PL/I, RPG, Autotest, 
Sort/Merge, and Utilities. The pro- 
grams in the relocatable library will 
subsequently be edited to run with a 
Supervisor that is adapted to the con- 
figuration of the individual installa- 
tion. 

3. Source statement library . Contains 
books in source-language format. The 
books supplied are macro definitions in 
the Assembler sub-library. Among the 
macro definitions in the Assembler sub- 
library are the Supervisor macros and 
the logical IOCS macros. 

The tape received by the user is capable 
of operating as a system. However, it is 
recommended that a Supervisor be assembled 
that is adapted to the configuration of the 
individual installation, and that the 
libraries of the system be edited according 
to the needs of the installation. When 
this process is completed, the newly creat- 
ed system replaces the system that was 
received by the user. 

The recommended procedure for generating 
a system that meets the requirements of the 
individual installation follows. 

1. Create a set of variable symbol state- 
ments. Since a Supervisor is assembled 
by using conditional assembly, a group 
of SET variable symbols is created to 
select various options, such as storage 
protection, timer feature, date conven- 
tion, etc. 



Catalog the set of variable symbol 
statements (called CONFIG) in the 
Assembler sub- library of the source 
statement library. The MAINT program 
is used for this catalog function. 



3. Assemble a new Supervisor. Assembly of 
the Supervisor depends conditionally 
upon the SET variable symbols defined 
by CONFIG. Therefore, a COPY CONFIG 
statement is included in each component 
of the Supervisor. 

4. Linkage-edit the Supervisor and catalog 
it in the core image library. Other 
system programs are linkage- edited and 
cataloged to run with the new Supervi- 
sor. Only those programs required for 
the system need be cataloged; the sel- 
ection depends upon the needs of the 
individual installation. The MAINT 
program is used for this catalog func- 
tion. 

5. Obtain backup by copying or punching 
the system. The MAINT or SSERV and 
RSERV programs are used for this func- 
tion. 

6. Delete the unused elements of the sys- 
tem for which backup has been obtained. 
The MAINT program is used for this 
function. 

7. Catalog installation programs, macro 
definitions, etc, by using the mainten- 
ance (MAINT) program. 
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APPENDIX A: STANDARD TAPE FILE LABEL 
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Label 
Identifier 



Version 
Number of 
Generation 



File 
Security 



The standard tape file label format and contents are as follows: 
FIELD NAME AND LENGTH 



LABEL IDENTIFIER 
3 bytes, EBCDIC 



FILE LABEL NUMBER 
1 byte, EBCDIC 



FILE IDENTIFIER 
17 bytes, EBCDIC 



FILE SERIAL NUMBER 
6 bytes, EBCDIC 



VOLUME SEQUENCE 
NUMBER 4 bytes 



FILE SEQUENCE NUMBER 
4 bytes 

GENERATION NUMBER 



4 bytes 



VERSION NUMBER OF 
GENERATION 2 bytes 



DESCRIPTION 


FIELD 


NAME AND LENGTH 


Identifies the type of label 


9. 


CREATION DATE 


HDR = Header — beginning of a data 




6 bytes 


file 






EOF = End of File ~ end of a set of 






data 






EOV = End of Volume -- end of the 






physical reel 







Always 1 



uniquely Identifies the entire file, 
may contoFn only printable characters. 

uniquely identifies a file/volume 
relationship. This field Is identical 
to the Volume Serial Number in the 
volume label of the first or only 
volume of a multi-volume file or a 
multi-file set. This field will 
normally be numeric (000001 to 
999999) but may contain any six 
alphameric characters, 

indicates the order of a volume in a 
given file or multi-file set. The 
first must be numbered 0001 and 
subsequent numbers must be in proper 
numeric sequence. 

assigns numeric sequence to a file 
within a multi-file set. The first 
must be numbered 0001 ,. 

uniquely identifies the various 
editions of the file. May be from 
0001 to 9999 In proper numeric 
sequence. 

indicates the version of a generation 
of a file. 



EXPIRATION DATE 
6 bytes 



FILE SECURITY 



1 byte 



BLOCK COUNT 



6 bytes 



SYSTEM CODE 
1 3 bytes 

RESERVED 
7 bytes 



DESCRIPTION 



indicates the year and the day of 
the year that the file was created: 



Position Code Meaning 



1 

2-3 
4-6 



blank none 

00-99 Year 

001-366 Day of Year 



(e.g., January 31, 1965 would 
be entered as 65031) 

Indicates the year and the day of 
the year when the file may become 
a scratch tape. The format of this 
field is identical to Field 9. On a 
multifile reel, processed sequential I/ 
all files are considered to expire on 
the same day , 

indicates security status of the file. 

= no security protection 

1 = security protection. Addit- 

ional identification of the 
file is required before it 
can be processed, 

indicates the number of data blocks 
written on the file from the last 
header label to the first trailer label 
exclusive of tape marks. Count does 
not Include checkpoint records. 
This field is used in Trailer Labels. 



uniquely identifies the progran 
system . 



ling 



Reserved for American Standarci 
Association (A,S,A.). At present, 
should be recorded as blanks. 
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APPENDIX B: OPERATOR- TO- SYSTEM COMMANDS 



Name 



Operation 



Operand 



Remarks 



ASSGN 



S YSxxx, address [,X'ss] [,^1^] [,TEMP] 



RESET 



blank 



SYSxxx: can be SYSRDR 
SYSIPT 
SYSPCH 
SYSLST 
SYSLOG 
SYSSLB 
SYSRLB 
SYS000-SYS244 

address: can be X'cuu', UA, or IGN 

X'cuu': c = 0-6 

uu = 00-FE (0-254) in hex 

UA: unassign 

IGN: unassign and ignore 

X'ss': used for 7-track tape only 





Bytes 




Trans- 






per 




late 


Convert 


ss 


Inch 


Parity 


Feature 


Feature 


10 


200 


odd 


off 


on 


20 


200 


even 


off 


off 


28 


200 


even 


on 


off 


30 


200 


odd 


off 


off 


38 


200 


odd 


on 


off 


50 


556 


odd 


off 


on 


60 


556 


even 


off 


off 


68 


556 


even 


on 


off 


70 


556 


odd 


off 


off 


78 


556 


odd 


on 


off 


90 


800 


odd 


off 


on 


AO 


800 


even 


off 


off 


A8 


800 


even 


on 


off 


BO 


800 


odd 


off 


off 


68 


800 


odd 


on 


off 



ALT: specifies alternate unit 

TEMP: assignment for logical unit will be 
destroyed by next JOB statement 



Resets I/O device assignments 



CLOSE 



SYSx 



SYSxxx: SYSLST, SYSPCH, or 
SYS000-SYS244 



DVCDN 



X'cuu' 



DVCUP 



X'cuu' 



X'cuu': c = 0-6 

uu = 00-FE (0-254) in hex 



X'cuu': c = 0-6 

uu = 00-FE (0-254) in hex 



MTC 



opcode, X'cuu' 



opcode: BSF, BSR, ERG, FSF, FSR, RUN, 
REW, or WTM 

X'cuu': c = 0-6 

uu = 00-FE (0-254) in hex 



CANCEL 



blank 



Cancels execution of current job 



PAUSE 



comments 



Causes pause at end of current [ob step 
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Name 


Operation 


Operand 


Remarks 




LISTIO 


(SYS ) 
\PROG f 
{UA \ 
1 DOWN I 
( SYSxxx ) 


Causes listing of I/O assignments 




LOG 


blank 


Causes logging of job control statements 
on SYSLOG 




NOLOG 


blank 


Suppresses logging of job control state- 
ments on SYSLOG 




SET 


[DATE=valuel] [,CLOCK=vaiue2] [,UPSI=value3] [,LINECT=vaiue4] 


value 1: in one of the following formats 

mm/dd/yy 
dd/mm/yy 

mm: month (01-12) 
dd: day (01-31) 
yy: year (00-99) 

value2: in the following format 

hh/mm/ss 

hh: hours (00-23) 
mm: minutes (00-59) 
ss: seconds (00-59) 

valueS: 0, 1, or X 

value4: standard number of lines for 

output on each page of SYSLST 




® 


blank 


0is alter code 5 
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APPENDIX C: JOB CONTROL STATEMENTS 



Name 


Operation 


Operand 


72 


Remarks 


// 


JOB 


jobname 


^ 


[obname: one to eight alphameric characters 


// 


EXEC 


[progname] 


h 


progname: one to eight alphameric characters. 

Used only if the program is in the core image library. 


// 


ASSGN 


SYSxxx, address[, X'ss'] [,ALT] 


K 


SYSxxx: can be SYSRDR 
SYSIPT 
SYSPCH 
SYSLST 
SYSLOG 
SYSSLB 
SYSRLB 
SYS000-SYS244 

address: can be X'cuu', UA, or IGN 

X'cuu': c = 0-6 

uu = 00-FE (0-254) in hex 

UA: unassign 

IGN: unassign and ignore 

X'ss': used for 7-track tape only 

Bytes Trans- 
per late Convert 
ss Inch Parity Feature Feature 

10 200 odd off on 
20 200 even off off 
28 200 even on off 
30 200 odd off off 
38 200 odd on off 
50 556 odd off on 
60 556 even off off 
68 556 even on off 
70 556 odd off off 
78 556 odd on off 
90 800 odd off on 
AO 800 even off off 
A8 800 even on off 
BO 800 odd off off 
B8 800 odd on off 

ALT: specifies alternate unit 


// 


RESET 


blank 


K 


Resets I/O device assignments 


// 


DATE 


mm/dd/yy 
or 


K 


mm: month (01-12) 
dd: day (01-^1) 






dd/mm/yy 


% 


yy: year (00-99) 


// 


UPSI 


nnnnnnnn 


K 


n: 0, 1, or X 


// 


VOL 


SYSxxx, filename 


K 


SYSxxx: can be SYSIPT 
SYSPCH 
SYS000-SYS244 










filename: one to eight alphabetic characters 


// 


TPLAB 


'label fields 3-10' 


K 


'label fields 3-10': indicated fields of the standard tape file label . 
A 49-byte character string, contained within 










single quotes. 


// 


TPLAB 


'label fields 3-10 label fields 
11-13' 


c 


'label fields 3-10: same as above 

C: any non-blank character in column 72 

label fields 11-13': 20-character direct continuation of the same 
character string begun with fields 3-10 (no 










blanks, quotes, or commas separating) 



66 



Name 


Operation 


, ... , ,. — 
Operand 


72 


Remarks 


// 


RSTRT 


jobname, SYSxxx, nnnn 


J^ 


jobname: one to eight alphameric character name of the job 
to be restarted 

SYSxxx: symbolic unit name of the device on which the check- 
point records are stored. Can be SYS000-SYS244. 

nnnn: one to four character identification of the checkpoint 
record to be used for restarting 


// 


LISTIO 


\ PROG / 
< UA > 
J DOWN \ 
[ SYSxxx ] 


K 


Causes listing of I/O assignments 


// 


OPTION 


option 1 [, option2, . . .] 


K 


option: can be any of the following 

LOG Log control statements on SYSLST 

NOLOG Suppress LOG option 

DUMP Dump registers and main storage on SYSLST 

in the case of abnormal program end 
NODUMP Suppress DUMP option 
LINK Write output of language translator on SYSOOO 

for linkage editing 
NOLINK Suppress LINK option 
DECK Output object module on SYSPCH 
NODECK Suppress DECK option 

LIST Output listing of source module on SYSLST 
NOLIST Suppress LIST option 

LISTX Output listing of object module on SYSLST 
NOLISTX Suppress LISTX option 
SYM Print symbol table on SYSLST and/or punch 

symbol deck on SYSPCH 
NOSYM Suppress SYM option 

XREF Output symbolic cross-reference list on SYSLST 
NOXREF Suppress XREF option 
ERRS Output listing of all errors in source program 

on SYSLST 
NOERRS Suppress ERRS option 
CATAL Catalog program or phase in core image library 

immediately after completion of Linkage Editor run 
48C 48-character set 
60C 60-character set 


// 


PAUSE 


[comments] 


K 


PAUSE statement is always printed on 1052 (SYSLOG). If no 1052 
is available, the statement is ignored. 


/* 


ignored 


ignored 


K 


Columns 1 and 2 are the only columns checked. 


/& 


ignored 


ignored 


K 


Columns 1 and 2 are the only columns checked. 


* 




comments 


¥ 


Column 2 must be blank. 
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GLOSSARY 



The explanations of the following terms 
relate to their use in the IBM Basic Oper- 
ating Systein/360 (26K Tape) publications. 
These explanations may differ from those in 
other publications. 

Basic Operating System/360 (16K Tape) ; A 
tape-resident system that provides 
operating system capabilities for 16K 
and larger System/36 tape configu- 
rations . 

Block ! 1. To group records physically for 
the purpose of conserving storage 
space or increasing the efficiency of 
access or processing. 

2. A physical record on tape. 

Book ; A source statement routine written 
in the Assembler or COBOL language. 

Buffer: 1. A storage device in which data 
is assembled temporarily during data 
transfers. It is used to compensate 
for a difference in the rate of flow 
of information or the time occurrence 
of events when transferring informa- 
tion from one device to another. For 
example, the IBM 2821 Control Unit (a 
control and buffer storage unit for 
card readers, card punches, and prin- 
ters in a System/360). 

2. A portion of main storage used for 
an input or output area. 

Catalog ; To enter a phase, module, or book 
into one of the system libraries as a 
permanent entry. 

Channel Program : One or more Channel Com- 
mand Words (CCW's) that control (s) a 
specific sequence of channel opera- 
tions. Execution of the specific 
sequence is initiated by a single 
START I/O instruction. 

Channel Scheduler ; The part of the Super- 
visor that controls the movement of 
data between main storage and 
input/output devices . 

Checkpoint ; A point in a program at which 
sufficient information can be stored 
to permit restarting the problem pro- 
gram from that point. 

Checkpoint Record ; Tape records that con- 
tain the status of the job and the 
system at the time the records are 
written by the checkpoint routine. 



These records provide the necessary 
information for restarting a job with- 
out having to return to the beginning 
of the job. 

Checkpoint/Restart ; A means of restarting 
execution of a program at some point 
other than the beginning. When a 
checkpoint macro instruction is issued 
in a problem program, checkpoint 
records are created. These records 
contain the status of the program and 
the machine. When it is necessary to 
restart a program at a point other 
than the beginning, the restart proce- 
dure uses the checkpoint records to 
reinitialize the system. 

Checkpoint Routine : A routine that records 
information for a checkpoint. 

Command Control Block ; A sixteen- byte 

field (five halfwords) required for 
each I/O device controlled by physical 
IOCS. This field is used for communi- 
cation between physical IOCS and the 
problem program. 

Communication Region : An area of the 

Supervisor set aside for interprogram 
and intraprogram communication. It 
contains information useful to both 
the Supervisor and the problem pro- 
gram. 

Control Program : A group of programs that 
provides functions such as the han- 
dling of input/output operations, 
error detection and recovery, program 
loading, and communication between the 
program and the operator. IPL, Super- 
visor, and Job Control make up the 
control program in the Basic Operating 
System/360 . 

Control Section ; The smallest separately 
relocatable unit of a program; that 
portion or text specified by the pro- 
grammer to be entity, all elements fo 
which are to be loaded into contiguous 
main storage locations. 

Core Image Library ; An area of the resi- 
dent system tape used to store pro- 
grams that have been processed by the 
Linkage Editor. Each program is in a 
form identical to that which it must 
have to be executable in main storage. 
The programs in the core image library 
include system programs, the librarian 
programs, and other IBM-supplied pro- 
grams such as Assembler, RPG, and sort 



68 



programs. Dser programs are also 
stored in the core image library.. 

Core Storage ; See Main Storage 

Data File ; A collection of related data 
records organized in a specific man- 
ner. For example, a payroll file (one 
record for each employee, showing his 
rate of pay, deductions, etc.) or an 
inventory file (one record for each 
inventory item, showing the cost, 
selling price, number in stock, etc.). 

External Reference ; A reference to a sym- 
bol used in another module. 

Fetch; 1. To bring a program phase into 
main storage from the core image 
library for immediate execution. 

2. The routine that retrieves 
requested phases and loads them into 
main storage. 

3. The name of a macro instruction 
(FETCH) used to transfer control to the 
System Loader. 

File; See Data File 

Fixed-Length Record ; A record having the 
same length as all other records with 
which it is logically or physically 
associated. 

Initial Program Loading (IPL); The ini- 
tialization procedure that causes 
Basic Operating System/360 to read 
programs into main storage. 

Input Job Stream ; A sequence of job con- 
trol statements entering the system, 
which may also include input data. 

Input/Output Control System (IOCS) ; A 

group of macro-instruction routines 
provided by IBM for handling the 
transfer of d^ta between main storage 
and external storage devices. IOCS 
consists of two parts; physical IOCS 
and logical IOCS. 

Interruption ; A break in the normal 

sequence of instruction execution. It 
causes an automatic transfer to a 
preset storage location where action 
is taken to satisfy the condition that 
caused the interruption, 

I/O Area ; An area (portion) of main stor- 
age into which data is read or from 
which data is written. In Operating 
System/ 360 publications, the term 
buffer is often used in place of I/O 
area . I/O means Input/Output. 

IPL Loader ; A program that reads the 



Supervisor into main storage and then 
transfers control to the Supervisor. 

Job Control ; A program that is called into 
storage to prepare each job or job 
step to be run. Some of its functions 
are to assign I/O devices to certain 
symbolic names, set switches for pro- 
gram use, log (or print) job control 
statements, and fetch the requested 
program phase. 

Job Control Statement ; Any one of the 

control statements in the input stream 
that identifies a job or job step or 
defines its requirements and options. 

Job Statement (JOB) ; The control statement 
in the input stream that identifies 
the beginning of a series of job con- 
trol statements for a single job i.e., 
a single accounting unit of process- 
ing. 

Job Step ; The execution of a single proc- 
essing program. 

K; 1024 

Language Translators ; A general term for 
any assembler, compiler, or other 
routine that accepts statements in one 
language and produces equivalent 
statements in another language. The 
Basic Operating System/360 has five 
language translators: Assembler, 
COBOL, FORTRAN, PL/I and RPG. 

Librarian; The set of programs that main- 
tains, services, and organizes the 
system libraries. 

Library ; An organized collection of pro- 
grams, source statements, or object 
modules maintained on the system- 
resident tape. Three libraries are 
used by the Basic Operating 
System/360; core image library, 
source statement library, and reloca- 
table library. 

Linkage Editor ; A system service program 
that edits the output of language 
translators and produces executable 
program phases. It relocates programs 
or program sections and links together 
separately assembled (or compiled) 
sections. 

Load; To fetch, i.e., to read a phase into 
main storage preparatory to executing 
it. 

Logic Module ; An accessing routine that 

provides an interface between a proc- 
essing program and physical IOCS. 

Logical File ; A data file that has been 
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described to the Basic Operating 
System/360 through the use of a file- 
definition (DTF) macro instruction. 
Note that a data file is described to 
Operating System/360 through a 
different defining method. Operating 
System/360 publications refer to a 
data file described in this different 
manner as a data set. 



Logical IOCS ; A comprehensive set of 

macro-instruction routines provided to 
handle the creation, retrieval, and 
maintenance of data files. 

Logical Record ; A record identified from 
the standpoint of its content, func- 
tion, and use rather than its physical 
attributes. It is meaningful with 
respect to the information it con- 
tains. (Contrasted with Physical 
Record . ) 

Main Storage ; All addressable storage from 
which instructions can be executed or 
from which data can be loaded directly 
into registers. 

Module (Programming) . The input to or 

output from a single execution of a 
language translator or the Linkage 
Editor; a separate program unit that 
can be combined with other units. 

Object Module : The output of a single exe- 
cution of a language translator; it 
constitutes input to the Linkage Edi- 
tor. An object module consists of one 
or more control sections in relocata- 
ble, non- executable form and an asso- 
ciated control dictionary. 

O perating System ; A collection of programs 
that enables a data processing system 
to supervise its own day-to-day opera- 
tions, automatically calling in pro- 
grams, routines, languages, and data 
as needed for continuous throughput of 
an uninterrupted series of jobs. 

O perating System/360 ; A modular and device 
independent operating system requiring 
direct access storage device resi- 
dence; the minimum main storage 
requirement is 32K. 

O verlap ; To do something at the same time 
that something else is being done; for 
example, to perform input/output oper- 
ations while instructions are being 
executed by the central processing 
unit. 

o verlay ; 1. A segment (phase) of a program 
retrieved into main storage, replacing 
all or part of a previously retrieved 
section. 



2 . The technique of repeatedly using 
the same blocks of internal storage 
during different stages of a problem. 
For example, when one routine is no 
longer needed in internal storage, 
another routine can replace all or 
part of that routine. 

Overrun: To lose data by performing an I/O 
operation before a previous I/O opera- 
tion on the same channel is complete. 

Phase ; The smallest complete unit that can 
be referenced in the core image 
library. Each overlay of a program or 
(if the program contains no overlays) 
the program itself is a single com- 
plete phase. 

Physical IOCS ; Macro instructions and 

Supervisor routines that schedule and 
supervise the execution of channel 
programs. Physical IOCS controls the 
actual transfer of records between the 
external storage medium and main stor- 
age. 

Physical Record : A record identified from 
the standpoint of the manner or form 
in which it is stored and retrieved; 
that is, one that is meaningful with 
respect to access. (Contrasted with 
Logical Records . ) 

Problem Program ; 1. The user's object 

program. It can be produced by any of 
the language translators. It consists 
of instructions necessary to solve the 
user's problem. 

2. A general term for any routine 
that is executed in the data process- 
ing system's problem state; that is, 
any routine that does not contain 
privileged operations. (Contrasted 
with Supervisor . ) 

Processing Program ; A general term for any 
program that is both loaded and super- 
vised by the control program. Speci- 
fically, a collection of certain IBM- 
supplied programs; the language 
translators, Autotest, Sort/Merge, and 
Utilities. The term processing pro- 
grams is in contrast to the term con- 
trol program . 

Queue : A list of entires, usually ordered 
in the sequence of arrival. The 
entries identify things contending for 
service or attention. 

Record ; A general term for any unit of data 
that is distinct from all others when 
considered in a particular context. 

Relocatable ; A module or control section 
whose address constants can be modi- 
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fied to compensate for a change in 
origin. 



Relocatable-Library Module ; A module con- 
sisting of one or more complete con- 
trol sections cataloged as a single 
entry in the relocatable library. 

Restart ; See Checkpoint/Restart 

Self-Relocating ; A programmed routine that 
is loaded at any double-word boundary 
and can adjust its constants so as to 
be executed at that location. 

Service Programs : Any of the class of 

standard routines that assist in the 
use of a data processing system and 
successful execution of problem pro- 
grams. These programs include Auto- 
test, Sort/Merge, and Utilities. 

Source Modul e; A set of source statements 

in the symbolic language of a language 
translator, that constitutes the 
entire input to a single execution of 
the language translator. 

Source Statement : Statements written by a 
programmer in symbolic terms related 
to a language translator such as 
Assembler or COBOL. 

Source Statement Library . A collection of 
books (such as macro definitions) 
cataloged onto the system tape by the 
Librarian. 

Stacked Job Processing : A technique that 

permits multiple job definitions to be 
grouped (stacked) for presentation to 
the system. This allows the system to 
automatically process each job in 
sequence. 

Supervisor ; A component of the control 

program. It consists of routines to 
control the functions of machine 
interruptions, external interruptions, 
operator communications, and physical 
IOCS requests and interruptions. 

Symbolic I/O Assignment : A means by which 
problem programs can refer to an I/O 
device by a symbolic name. Before a 
program is executed. Job Control can 
be used to assign a specific I/O 
device to that symbolic name. 



System Loader : One of the Supervisor rou- 
tines. It is used to retrieve program 
phases from the core image library and 
load them into main storage. System 
Pack; The pack in which the Basic 
Operating System resides. 



System Residence ; The external storage 

space allocated for storing the basic 
operating system. It refers to an 
on-line tape reel that contains the 
necessary programs required for exe- 
cuting a job on the data processing 
system. 

System Service Programs ; Programs that 

perform portions of the functions of 
generating the initial basic operating 
system, generating specialized sys- 
tems, creating and maintaining the 
library sections, and loading and 
editing programs onto the resident 
tape. These programs are: Linkage 
Editor and Librarian. 

Tape-Resident System ; An operating system 
that uses magnetic tape for on-line 
storage of system routines. 

Throughput ; A measure of system efficiency; 
the rate at which work can be handled 
by a data processing system. 

Transient Area ; This is a main storage area 
(within the Supervisor area) used for 
temporary storage of transient rou- 
tines. 

Transient Routines : These routines are 
permanently stored on the system- 
residence tape and loaded (by the 
Supervisor) into the transient area 
when needed for execution. 

Undefined Record ; A record having an 
unspecified or unknown length. 

Variable- Length Record ; A record having a 
length independent of the length of 
other records with which it is logi- 
cally or physically associated. 
(Contrasted with Fixed- Length Record . ) 

Volume: That portion of a single unit of 
storage media that is accessible to a 
single read/write mechanism. For 
example, a reel of magnetic tape on a 
2400-series magnetic tape drive- 
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* — Comments Statement 31 

/* — End of Data File Statement 
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/& — End of Job Statement 
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Abort 13 

ACTION Statement 4 3 

ACTION Statement 39 

ADD 34 

Assemble-and-Execute 39 

ASSGN — Assign Logical Name Command 16 

ASSGN Statement 26 

@ — End-of-Communication Command 19 

CANCEL 11 

CANCEL — Cancel Job Command 18 

Catalog 49 

Catalog (Core Image Library) 50 

Catalog Programs in Core Image Library 3 8 

Catalog (Relocatable Library) 57 

Catalog (Source Statement Library) 52 

CCB 15 

Channel, Multiplexor 14 

Channel Scheduler 13 

Channel Scheduler Functions 14 

Channel, Selector 14 

Checkpoint/Restart 20 

Checkpoint, Restarting Programs from 2 5 

CHKPT 11 

CHKPT Macro Instruction 20 

CLOSE 11 

CLOSE System Files 31 

CLOSE - Close System Output Unit 

Command 17 
Commands, Information 18 
Commands , I/O 16 
Commands, Job Control 18 
Conununication from the Operator 16 
Communication Region Macros 10 
Communication to the Operator 16 
Communication REgion 8 
Communication Region, Setting Up 25 
COMRG 10 

Control Dictionary 3 8 
Control Program 5 
Control Section 36 
Control Statement Conventions 7 
Control Statement Effect on I/O Units 31 
Control Statement Format (Job Control) 25 
Control Statement Format (Librarian) 49 
Control Statement Format , Linkage 

Editor 40 
Control Statement Placement, Linkage 

Editor 40 
Control Statements, Linkage Editor 39 
Conventions , Control Statement 7 
Copy 39 

Copy (Core Image Library) 51 
Copy (Relocatable Library) 5 8 
Copy (Source Statement Library) 54 
Core Image Library 5, 46 
Core Image Library: Maintenance 

Functions 50 



DATE Statement 27 

DEL 34 

Delete 49 

Delete (Core Image Library) 51 

Delete (Source Statement Library) 53 

Description and Format of Job Control 

Statements 26 
Device Error Recovery 15 
Directories: Librarian Functions 61 
Display 49 

49 
(Relocatable 



(Source Statement 



Display and Punch 
Display and Punch 

Library 60 
Display and Punch 

Library) 4 8 
Display (Relocatable Library) 59 
Delete (Relocatable Library) 58 
Display (Source Statement Library) 
DUMP 11 

Dump and Abort 13 
DyCDN — Device Down Command 17 
DVCUP — Device Up Command 17 
ENTRY Statement 39, 43 
EOJ 11 

Error Recovery 15 
Example of Linkage Editor Input and 

Output 44 
EXCP 11, 15 
EXEC Statement 26 
EXIT 11, 13 
External Interruption 12 
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FETCH 11, 20 

FETCH Macro Instruction 20 
Functions, Channel Scheduler 
Functions, Job Control 22 
Functions, Supervisor 8, 10 
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GETIME 



11, 12 



13 



INCLUDE Statement 42, 39 
Information Commands 18 
Input/Output Interruption 
Interruption, External 12 
Interruption, Input/Output 
Interruption Handling 10 
Interruption, Machine Check 
Interruption, Program Check 
Interruption, Supervisor Call 
I/O Commands 16 
I/O Units Control Tables 8 
IPL Loader 34, 5 



Job Control 5, 22 

Job Control Commands 18 

Job Control Functions 22 

Job Control Statements 25 

Job Date 25 

Job Name 25 

JOB Statement 26 

Job Control Statement Example 



13 

13 
13 
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DATE 



19 



Label Checking 21 
Language Translator 
LBRET 11 
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Source Statement 
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Librarian 5, 46 
Librarian Functions 47 
Librarian Functions: Core Image 

Library 50 
Librarian Functions: Directories 61 
Librarian Functions: Relocatable 

Library 57 
Librarian Functions 

Library 52 
Linkage Editor 5, 36 
Linkage Editor Control Statements 
Linkage Editor Control Statement 

Format 40 
Linkage Editor Control Statement 

Placement 40 
Linkage Editor Runs, Types of 38 
LISTIO -- List I/O Assignment Command 
LISTIO Statement 29 
Load-and-Execute 39 
LOAD 11 

LOAD Macro Instruction 20 
LOG - Log Command 18 
Logical Unit Block (LUB) 8, 23 
Logical Units, Programmer 2 3 
Logical Units, System 2 3 
LUB (Logical Unit Block) 8, 23 



Machine Check Interruption 13 
Machine Requirements 6 
Main Storage Organization 8 
Maintenance Functions 49 
Maintenance Functions (Core Image 

Library) 50 
Maintenance Functions (Relocatable 

Library) 57 
Maintenance Functions (Source Statement 

Library) 52 
Module, Object 36 
Module, Source 36 
MTC - Magnetic Tape Control Command 
Multiplexor Channel 14 
MVCOM 10, 9 

NMTLB Statement 2 8 

NOLOG - Suppress Logging Command 18 
Normal and Abnormal End-of-Job 
Handling 21 

Object Module 36 
OPEN 11 

OPEN System Files 31 
Operator Communication 15 
Operator to System Commands 16 
OPTION Statement 29 
Organization, Main Storage 8 
Overlay 38 

PAUSE - Pause Command 18 

PAUSE Statement 30 

Phase 38 

Phase Entry Point 43 

PHASE Statement 39, 40 

Physical I/O Macros 15 

PUB (Physical Unit Block) 8, 23 

Physical Unit Block (PUB) 8, 23 

Prepare Programs for Execution 22 

Processing Programs 6 



Program 36 

Program Check Interruption 13 

Program Development 36 

Program Phase 38 

Program Structure 36 

Programmer Logical Units 2 3 

Punch 49 

Punch (Relocatable Library) 59 

Punch (Source Statement Library) 
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Queue 14 



6, 46 
Maintenance 



Service Functions 



Relocatable Library 
Relocatable Library: 

Functions 5 7 
Relocatable Library: 
18 REP Card 43 

RESET - Reset I/O Assignments Command 

I^SET Statement 2 7 

Hestart/Checkpoint 20 

llestarting Programs from Checkpoint 

TISTRT Statement 2 8 

Huns, Linkage Editor 38 

Selector Channel 14 

Sequence of Job Control Statements 
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17 



25 



26 



49 
(Relocatable 



(Source Statement 



25 



Service FHinctions 
Service F'unctions 

Library) 59 
Service Functions 

Library) 5 4 
SET 34 

SET - Set Value Command 1 
Get Up Communication Region 
SETIME 11, 13 
Source Module 36 
Source Statement Library 
Source Statement Library 

Functions 52 
17 Source Statement Library 

Functions 5 4 
Sources of Linkage Editor Input 
States of Program Development 
Storage Protection 10 
Structure of a Program 36 
STXIT 11, 13 
Sub-library 46 
Supervisor 5 , 8 
Supervisor Call Interruption 
Supervisor Functions 8, 10 
Symbolic I/O Assignment 2 2 
Symbolic Units 22 



5, 46 
Maintenance 



Service 
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36 



11 



SYSIPT 


22 


SYSLOG 


22 


SYSLST 


22 


SYSPCH 


22 


SYSRDR 


22 


SYSRES 


22 


SYSRLB 


23 


SYSSLB 


22 
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System Configuration 

System Generation 61 

System I/O Operations 

System Loader 19, 36 

System Logical Units 
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